投射 框架。 系统
这是 cast.framework.system
命名空间。
类
应用数据
描述已启动应用的数据的元数据。
活动
由 cast.framework.CastReceiverContext 分派的事件,包含系统信息。
FeedbackStartedEvent
系统开始创建反馈报告时,由 cast.framework.CastReceiverContext 分派的事件。
MaxVideoResolutionChangedEvent
当系统需要更新视频分辨率上限时,由 cast.framework.CastReceiverContext 分派的事件。
ReadyEvent(就绪事件)
当系统准备就绪时,由 cast.framework.CastReceiverContext 分派的事件。
发送者
这表示已连接发送者设备的数据。
SenderConnectedEvent(发送者连接事件)
连接发送者后由 cast.framework.CastReceiverContext 分派的事件。
发件人已断开连接事件
与发送者断开连接时由 cast.framework.CastReceiverContext 分派的事件。
关停事件
在应用关闭时由 cast.framework.CastReceiverContext 分派的事件。
StandbyChangedEvent
当电视进入或退出待机状态时,由 cast.framework.CastReceiverContext 分派的事件,因此应用应始终验证 isStandby
属性。如需了解实际状态是否未知,应用可以调用 cast.framework.CastReceiverContext#getStandbyState 方法。
SystemVolumeChangedEvent
当系统音量发生变化时,由 cast.framework.CastReceiverContext 分派的事件。
系统卷数据
这表示系统音量数据。
VisibilityChangedEvent
当应用可见性发生变化(例如,HDMI 输入发生更改或电视关闭)时,由 cast.framework.CastReceiverContext 分派的事件。
枚举
DeviceCapabilities
字符串
介绍了当前设置的功能,这些功能由支持 Cast 的设备及其连接的显示设备(如果适用)组成。
值 |
|
---|---|
音频助理 |
字符串 音频助理支持。支持 Google 助理且支持 Cast 的设备示例包括 Google Home 和 Google Home Mini。 |
蓝牙_受支持 |
字符串 蓝牙支持。 |
已展示广告 |
字符串 显示输出支持。支持 Chromecast 的投射设备示例包括 Chromecast 和 Cast TV。不支持显示屏的投射设备示例包括 Chromecast Audio 和 Google Home。 |
HI_RES_AUDIO_SUPPORTED |
字符串 支持高解析度音频(高达 24 位 / 96KHz)。 |
IS_DV_SUPPORTED |
字符串 杜比视界支持。 |
IS_HDR_受支持 |
字符串 支持 HDR 视频。 |
触控输入 |
字符串 触摸输入支持。支持触控输入且支持 Cast 的设备示例包括 Google Nest Hub 和 Google Nest Hub Max。 |
IS_GROUP |
字符串 如果设备是虚拟设备并代表组目标,而不是物理设备。 |
已获取设备 |
字符串 如果设置为 |
IS_CBCS_SUPPORTED |
字符串 如果设置为 |
IS_DOLBY_ATMOS_SUPPORTED |
字符串 设置为 |
断开连接原因
字符串
表示断开连接的原因。
值 |
|
---|---|
请求者_发件人 |
字符串 发送者应用主动请求关闭连接(通常由用户触发)。 |
错误 |
字符串 出现协议错误。 |
未知 |
字符串 发件人是否通过调用 |
事件类型
字符串
由 cast.framework.CastReceiverContext 分派的系统事件。
值 |
|
---|---|
准备就绪 |
字符串 在系统准备就绪时触发。 |
SHUTDOWN |
字符串 在应用终止时触发。 |
发件人:CONNECTED |
字符串 在有新的发送者连接时触发。 |
发件人:已断开连接 |
字符串 在发送者断开连接时触发。 |
错误 |
字符串 在系统出错时触发。 |
更改了系统状态 |
字符串 在系统音量发生变化时触发。 |
曝光度已更改 |
字符串 当应用的可见性发生变化(例如,在 HDMI 输入源发生更改,或者电视关闭/打开且 Cast 设备由外部电源供电)时触发。请注意,此 API 与浏览器引发的“webkitVisibilitychange”事件具有相同的效果。为方便起见,以及避免依赖 webkit 前缀的事件,可将其作为 cast.framework.CastReceiverContext API 提供。 |
待机模式 |
字符串 在电视待机状态更改时触发。此事件与 cast.framework.system.EventType.VISIBILITY_CHANGED 事件相关,因为如果 TV 处于待机模式,可见性将为 可见性状态比待机状态更精细(因为可见性还包含电视频道选择),但并非所有电视都能可靠地检测到。在这些情况下,用户可以使用待机模式,因为大多数电视都会实现这种模式。 |
更改了 MAX_VIDEO_RESOLUTION__ 项 |
字符串 |
反馈开始 |
字符串 当系统开始创建反馈报告时触发。 |
开始时间
字符串
这表示启动了哪些类型的请求。
值 |
|
---|---|
未知 |
字符串 无法确定发布所有者。 |
DIAL |
字符串 应用已通过 DIAL 请求启动。 |
CAST |
字符串 应用已通过 Cast V2 请求启动。 |
云 |
字符串 应用通过 Google 助理请求启动(例如,通过 Google 助理命令)。 |
MessageType
字符串
自定义消息的类型。
值 |
|
---|---|
STRING |
字符串 消息为自由格式的字符串。应用负责对传输的信息进行编码/解码。 |
JSON |
字符串 消息采用 JSON 编码。底层传输将使用 JSON 编码的字符串。 |
待机状态
字符串
这表示平台报告的当前待机状态。如果 Cast 平台无法确定状态,则可能是 UNKNOWN
。
值 |
|
---|---|
备用 |
字符串 |
非待机 |
字符串 |
未知 |
字符串 |
系统状态
字符串
这表示当前系统状态。
值 |
|
---|---|
尚未开始 |
字符串 该应用尚未启动请求。 |
背景背景 |
字符串 应用正在启动,但对用户不可见。 |
正在启动 |
字符串 应用正在启动。 |
准备就绪 |
字符串 应用在前台运行,并已准备好收发消息。 |
停止在背景中显示 |
字符串 应用在后台运行时停止。 |
正在停止 |
字符串 应用正在停止。 |
VisibilityState
字符串
这表示平台报告的当前可见性状态。如果 Cast 平台无法确定可见性状态,则可能是 UNKNOWN
。
值 |
|
---|---|
VISIBLE |
字符串 |
不可见 |
字符串 |
未知 |
字符串 |
属性
DeviceCapabilities
字符串
介绍了当前设置的功能,这些功能由支持 Cast 的设备及其连接的显示设备(如果适用)组成。
值 |
|
---|---|
音频助理 |
字符串 音频助理支持。支持 Google 助理且支持 Cast 的设备示例包括 Google Home 和 Google Home Mini。 |
蓝牙_受支持 |
字符串 蓝牙支持。 |
已展示广告 |
字符串 显示输出支持。支持 Chromecast 的投射设备示例包括 Chromecast 和 Cast TV。不支持显示屏的投射设备示例包括 Chromecast Audio 和 Google Home。 |
HI_RES_AUDIO_SUPPORTED |
字符串 支持高解析度音频(高达 24 位 / 96KHz)。 |
IS_DV_SUPPORTED |
字符串 杜比视界支持。 |
IS_HDR_受支持 |
字符串 支持 HDR 视频。 |
触控输入 |
字符串 触摸输入支持。支持触控输入且支持 Cast 的设备示例包括 Google Nest Hub 和 Google Nest Hub Max。 |
IS_GROUP |
字符串 如果设备是虚拟设备并代表组目标,而不是物理设备。 |
已获取设备 |
字符串 如果设置为 |
IS_CBCS_SUPPORTED |
字符串 如果设置为 |
IS_DOLBY_ATMOS_SUPPORTED |
字符串 设置为 |
断开连接原因
字符串
表示断开连接的原因。
值 |
|
---|---|
请求者_发件人 |
字符串 发送者应用主动请求关闭连接(通常由用户触发)。 |
错误 |
字符串 出现协议错误。 |
未知 |
字符串 发件人是否通过调用 |
事件类型
字符串
由 cast.framework.CastReceiverContext 分派的系统事件。
值 |
|
---|---|
准备就绪 |
字符串 在系统准备就绪时触发。 |
SHUTDOWN |
字符串 在应用终止时触发。 |
发件人:CONNECTED |
字符串 在有新的发送者连接时触发。 |
发件人:已断开连接 |
字符串 在发送者断开连接时触发。 |
错误 |
字符串 在系统出错时触发。 |
更改了系统状态 |
字符串 在系统音量发生变化时触发。 |
曝光度已更改 |
字符串 当应用的可见性发生变化(例如,在 HDMI 输入源发生更改,或者电视关闭/打开且 Cast 设备由外部电源供电)时触发。请注意,此 API 与浏览器引发的“webkitVisibilitychange”事件具有相同的效果。为方便起见,以及避免依赖 webkit 前缀的事件,可将其作为 cast.framework.CastReceiverContext API 提供。 |
待机模式 |
字符串 在电视待机状态更改时触发。此事件与 cast.framework.system.EventType.VISIBILITY_CHANGED 事件相关,因为如果 TV 处于待机模式,可见性将为 可见性状态比待机状态更精细(因为可见性还包含电视频道选择),但并非所有电视都能可靠地检测到。在这些情况下,用户可以使用待机模式,因为大多数电视都会实现这种模式。 |
更改了 MAX_VIDEO_RESOLUTION__ 项 |
字符串 |
反馈开始 |
字符串 当系统开始创建反馈报告时触发。 |
开始时间
字符串
这表示启动了哪些类型的请求。
值 |
|
---|---|
未知 |
字符串 无法确定发布所有者。 |
DIAL |
字符串 应用已通过 DIAL 请求启动。 |
CAST |
字符串 应用已通过 Cast V2 请求启动。 |
云 |
字符串 应用通过 Google 助理请求启动(例如,通过 Google 助理命令)。 |
MessageType
字符串
自定义消息的类型。
值 |
|
---|---|
STRING |
字符串 消息为自由格式的字符串。应用负责对传输的信息进行编码/解码。 |
JSON |
字符串 消息采用 JSON 编码。底层传输将使用 JSON 编码的字符串。 |
待机状态
字符串
这表示平台报告的当前待机状态。如果 Cast 平台无法确定状态,则可能是 UNKNOWN
。
值 |
|
---|---|
备用 |
字符串 |
非待机 |
字符串 |
未知 |
字符串 |
系统状态
字符串
这表示当前系统状态。
值 |
|
---|---|
尚未开始 |
字符串 该应用尚未启动请求。 |
背景背景 |
字符串 应用正在启动,但对用户不可见。 |
正在启动 |
字符串 应用正在启动。 |
准备就绪 |
字符串 应用在前台运行,并已准备好收发消息。 |
停止在背景中显示 |
字符串 应用在后台运行时停止。 |
正在停止 |
字符串 应用正在停止。 |
VisibilityState
字符串
这表示平台报告的当前可见性状态。如果 Cast 平台无法确定可见性状态,则可能是 UNKNOWN
。
值 |
|
---|---|
VISIBLE |
字符串 |
不可见 |
字符串 |
未知 |
字符串 |