cast. framework. CastReceiverOptions
Cast 接收器上下文选项。 所有属性都是可选的。
构造函数
CastReceiverOptions
new CastReceiverOptions()
属性
adBreakPreloadTime
(数字或未定义)
我们应提前多长时间预加载单个广告 插播时间段的内容,以秒为单位。这样可以避免过早预加载广告插播时间点,从而混淆广告指标。如果未提供,则使用默认值 5 秒。
customNamespaces
具有非 null cast.framework.system.MessageType 属性的非 null 对象
自定义消息命名空间及其类型的映射。自定义 消息命名空间必须在应用 启动之前初始化,因此必须在接收器选项中提供。 (如果此处未提供,则默认消息类型为 JSON)。
disableIdleTimeout
(布尔值或未定义)
如果为 true,则在活跃播放停止后接收器进入空闲状态时,系统不会关闭接收器 。此属性应仅用于 非媒体应用。
enforceSupportedCommands
布尔值
如果为 true,则任何不在 supportedCommands 映射中的媒体命令都会 生成错误。cast.framework.messages.ErrorReason 将设置为 NOT_SUPPORTED。默认值为 false,这允许执行媒体命令 而不检查映射。
localSenderId
(字符串或未定义)
用于本地请求的发送方 ID。默认值为“local”。
maxInactivity
(数字或未定义)
关闭空闲 发送方连接之前的最长时间(以秒为单位)。设置此值可启用检测信号消息,以保持连接处于活跃状态。 用于比 典型的 TCP 超时更快地检测无响应的发送方。最小值为 5 秒;没有强制执行上限,但通常需要几分钟时间平台 TCP 超时才会生效。默认值为 10 秒。
mediaElement
(非 null HTMLMediaElement 或未定义)
用于播放内容的媒体元素。默认行为是使用 页面中找到的第一个媒体元素。
playbackConfig
(非 null cast.framework.PlaybackConfig 或未定义)
具有自定义参数的播放配置。
playWatchedBreak
(布尔值或未定义)
如果为 true,即使客户端拼接的插播时间段已观看过,也会播放 。
preferredPlaybackRate
(数字或未定义)
如果加载请求中未指定,则使用的播放速度。允许的 范围为 0.5 到 2,其中 1 为正常速度。
preferredTextLanguage
(字符串或未定义)
如果加载请求未 指定活跃轨道,则用于文本轨道的语言。
queue
(非 null cast.framework.QueueBase 或未定义)
自定义队列实现。
shakaVariant
(非 null cast.framework.ShakaVariant 或未定义)
应加载哪个版本的 Shaka Player。设置为
cast.framework.ShakaVariant.DEBUG 以加载调试 build。
shakaVersion
(字符串或未定义)
采用 MAJOR.MINOR.PATCH 或 MAJOR.MINOR.PATCH-SUFFIX 格式的 Shaka 版本,例如“4.15.35”(当前默认版本)。
支持的版本为 >=4.15.35 <5.0.0。 已废弃但仍兼容的版本为 >=2.5.6 <4.15.35。
注意:不建议使用低于默认版本的 Shaka Player 版本,因为最新版本中已修复许多错误。您可以在此处指定较新版本,以选择使用默认情况下尚不可用的其他修复或功能。不过,请注意,Web 接收器 SDK 的未来版本可能会更改支持的版本范围,并强制使用您在此处指定的版本以外的版本。此标志 应仅作为临时措施使用,并且应在 Cast 支持团队的指导下使用。(https://developers.google.com/cast/support)使用风险自负。
skipMplLoad
(布尔值或未定义)
如果为 true,则阻止接收器加载 MPL 播放器。
skipPlayersLoad
(布尔值或未定义)
如果为 true,则阻止接收器加载 MPL 或 Shaka 播放器 库。相当于将 skipMplLoad 和 skipShakaLoad 都设置为 true。
skipShakaLoad
(布尔值或未定义)
如果为 true,则阻止接收器加载 Shaka 播放器。
statusText
(字符串或未定义)
表示应用状态的文本。它应符合 国际化规则,因为发送方应用可能会显示它。
supportedCommands
(数字或未定义)
应用支持的媒体命令 的位掩码。必须始终支持 LOAD、PLAY、STOP、GET_STATUS 。如果未提供此值,则系统还会假定支持 PAUSE、SEEK、 STREAM_VOLUME、STREAM_MUTE、EDIT_TRACKS 和 PLAYBACK_RATE。
uiConfig
(非 null cast.framework.ui.UiConfig 或未定义)
界面配置。
useLegacyDashSupport
(布尔值或未定义)
如果为 true,则对 DASH 内容使用 MPL。
useShakaForHls
(布尔值或未定义)
如果为 true,则对 HLS 内容使用 Shaka Player。默认值为 false。
注意:Shaka Player 不是 HLS 内容的默认播放器,因为仍缺少一些功能,并且我们希望确保它具有高性能且与 HLS 接收器广泛兼容,然后再将其设为默认播放器。如果您在正式发布之前选择使用 Shaka Player 播放 HLS 内容,请务必报告您遇到的任何问题。 (https://developers.google.com/cast/support)在 Shaka Player for HLS 全面发布之前 我们不保证 Shaka Player 与 HLS 的兼容性,如果您遇到非小问题,我们可能会建议您将此标志恢复为默认设置 。
versionCode
(数字或未定义)
一个整数,用作内部版本号来表示接收器 版本。此数字仅用于在收集指标时区分接收器 版本。它应随着每个 版本的发布而递增,并在回滚时保持与该版本绑定。