cast. 框架. 系统
这是 cast.framework.system
命名空间。
类
ApplicationData
描述已启动应用的数据的元数据。
事件
由 cast.framework.CastReceiverContext 分派的事件,其中包含系统信息。
FeedbackStartedEvent
系统开始创建反馈报告时,由 cast.framework.CastReceiverContext 分派的事件。
MaxVideoResolutionChangedEvent
当系统需要更新对最大视频分辨率的限制时,由 cast.framework.CastReceiverContext 分派的事件。
消息
发件人发来的自定义消息。要监听自定义事件,请使用 cast.framework.CastReceiverContext#addCustomMessageListener 方法。
ReadyEvent
系统准备就绪时由 cast.framework.CastReceiverContext 分派的事件。
发件人
这表示已连接的发送设备的数据。
SenderConnectedEvent
连接发送器时由 cast.framework.CastReceiverContext 分派的事件。
SenderDisconnectedEvent
当发送器断开连接时,由 cast.framework.CastReceiverContext 分派的事件。
ShutdownEvent
应用关闭时由 cast.framework.CastReceiverContext 分派的事件。
StandbyChangedEvent
当电视进入或退出待机状态时,由 cast.framework.CastReceiverContext 分派的事件,因此应用应始终验证 isStandby
属性。要了解实际状态是否未知,应用可以调用 cast.framework.CastReceiverContext#getStandbyState 方法。
SystemVolumeChangedEvent
系统音量发生变化时,由 cast.framework.CastReceiverContext 分派的事件。
SystemVolumeData
这表示系统卷数据。
VisibilityChangedEvent
在应用可见性发生变化(例如,HDMI 输入发生变化或电视关闭)时,由 cast.framework.CastReceiverContext 分派的事件。
枚举
DeviceCapabilities
string
说明当前设置的功能,由支持 Cast 的设备及其连接的显示设备(如果适用)组成。
值 |
|
---|---|
AUDIO_ASSISTANT |
string 音频助理支持。支持 Google Cast 且支持音频助理的设备的示例包括 Google Home 和 Google Home Mini。 |
BLUETOOTH_SUPPORTED |
string 支持蓝牙。 |
DISPLAY_SUPPORTED |
string 显示输出支持。具有显示屏支持、支持 Cast 的设备的示例包括 Chromecast 和 Cast TV。不支持显示屏的支持 Cast 的设备示例包括 Chromecast Audio 和 Google Home。 |
HI_RES_AUDIO_SUPPORTED |
string 支持高分辨率音频(最高可达 24 位 / 96KHz)。 |
IS_DV_SUPPORTED |
string 支持杜比视界。 |
IS_HDR_SUPPORTED |
string 支持 HDR 视频。 |
TOUCH_INPUT_SUPPORTED |
string 支持触控输入。例如,Google Nest Hub 和 Google Nest Hub Max 支持触控输入的支持 Cast 的设备。 |
IS_GROUP |
string 如果设备是虚拟设备,并且表示组目标而不是实体设备。 |
IS_DEVICE_REGISTERED |
string 当设置为 |
IS_CBCS_SUPPORTED |
string 当设为 |
IS_DOLBY_ATMOS_SUPPORTED |
string 当设置为 |
DisconnectReason
string
表示断开连接的原因。
值 |
|
---|---|
REQUESTED_BY_SENDER |
string 发送方应用已主动请求关闭连接(通常由用户触发)。 |
错误 |
string 出现协议错误。 |
未知 |
string 未知发送者是否通过调用 |
EventType
string
cast.framework.CastReceiverContext 分派的系统事件。
值 |
|
---|---|
准备就绪 |
string 在系统就绪时触发。 |
SHUTDOWN |
string 在应用终止时触发。 |
SENDER_CONNECTED |
string 在新发送者连接时触发。 |
SENDER_DISCONNECTED |
string 在发送者断开连接时触发。 |
错误 |
string 在出现系统错误时触发。 |
SYSTEM_VOLUME_CHANGED |
string 在系统音量改变时触发。 |
VISIBILITY_CHANGED |
string 在应用可见性发生变化(例如,HDMI 输入发生变化,或电视关闭或开启且 Cast 设备由外接电源)时触发。请注意,此 API 与浏览器引发的“webkitvisibilitychange”事件的效果相同。以 cast.framework.CastReceiverContext API 的形式提供此 API 是为了方便您执行操作以及避免依赖于带有 webkit 前缀的事件。 |
STANDBY_CHANGED |
string 在电视待机状态发生变化时触发。此事件与 cast.framework.system.EventType.VISIBILITY_CHANGED 事件相关,因为如果电视处于待机模式,则可见性将为 可见性状态比待机状态更精细(因为可见性状态还包括电视频道的选择),但并非在所有电视中都能可靠地检测到。在这些情况下,可以使用待机模式,因为大多数电视都实现了待机模式。 |
MAX_VIDEO_RESOLUTION_CHANGED |
string |
FEEDBACK_STARTED |
string 系统开始创建反馈报告时触发。 |
LaunchedFrom
string
表示启动接收器的请求类型。
值 |
|
---|---|
未知 |
string 无法确定发布负责人。 |
DIAL |
string 应用已由 DIAL 请求启动。 |
CAST |
string 应用由 Cast V2 请求启动。 |
云端 |
string 应用由 Google 助理请求(例如,通过 Google 助理指令)启动。 |
MessageType
string
自定义消息的类型。
值 |
|
---|---|
字符串 |
string 消息是自由格式的字符串。应用负责对传输的信息进行编码/解码。 |
JSON |
string 消息采用 JSON 编码。底层传输将使用 JSON 编码的字符串。 |
StandbyState
string
这表示平台报告的当前待机状态。如果 Cast 平台无法确定状态,则可能为 UNKNOWN
。
值 |
|
---|---|
待用 |
string |
NOT_STANDBY |
string |
未知 |
string |
SystemState
string
这表示当前的系统状态。
值 |
|
---|---|
NOT_STARTED |
string 尚未请求开始申请。 |
STARTING_IN_BACKGROUND |
string 应用正在启动,但用户看不到。 |
正在启动 |
string 应用正在启动。 |
准备就绪 |
string 应用位于前台,已准备好收发消息。 |
STOPPING_IN_BACKGROUND |
string 应用正在后台停止运行。 |
正在停止 |
string 应用正在停止运行。 |
VisibilityState
string
这表示平台报告的当前可见性状态。如果 Cast 平台无法确定可见性状态,则可能为 UNKNOWN
。
值 |
|
---|---|
VISIBLE |
string |
NOT_VISIBLE |
string |
未知 |
string |
属性
DeviceCapabilities
string
说明当前设置的功能,由支持 Cast 的设备及其连接的显示设备(如果适用)组成。
值 |
|
---|---|
AUDIO_ASSISTANT |
string 音频助理支持。支持 Google Cast 且支持音频助理的设备的示例包括 Google Home 和 Google Home Mini。 |
BLUETOOTH_SUPPORTED |
string 支持蓝牙。 |
DISPLAY_SUPPORTED |
string 显示输出支持。具有显示屏支持、支持 Cast 的设备的示例包括 Chromecast 和 Cast TV。不支持显示屏的支持 Cast 的设备示例包括 Chromecast Audio 和 Google Home。 |
HI_RES_AUDIO_SUPPORTED |
string 支持高分辨率音频(最高可达 24 位 / 96KHz)。 |
IS_DV_SUPPORTED |
string 支持杜比视界。 |
IS_HDR_SUPPORTED |
string 支持 HDR 视频。 |
TOUCH_INPUT_SUPPORTED |
string 支持触控输入。例如,Google Nest Hub 和 Google Nest Hub Max 支持触控输入的支持 Cast 的设备。 |
IS_GROUP |
string 如果设备是虚拟设备,并且表示组目标而不是实体设备。 |
IS_DEVICE_REGISTERED |
string 当设置为 |
IS_CBCS_SUPPORTED |
string 当设为 |
IS_DOLBY_ATMOS_SUPPORTED |
string 当设置为 |
DisconnectReason
string
表示断开连接的原因。
值 |
|
---|---|
REQUESTED_BY_SENDER |
string 发送方应用已主动请求关闭连接(通常由用户触发)。 |
错误 |
string 出现协议错误。 |
未知 |
string 未知发送者是否通过调用 |
EventType
string
cast.framework.CastReceiverContext 分派的系统事件。
值 |
|
---|---|
准备就绪 |
string 在系统就绪时触发。 |
SHUTDOWN |
string 在应用终止时触发。 |
SENDER_CONNECTED |
string 在新发送者连接时触发。 |
SENDER_DISCONNECTED |
string 在发送者断开连接时触发。 |
错误 |
string 在出现系统错误时触发。 |
SYSTEM_VOLUME_CHANGED |
string 在系统音量改变时触发。 |
VISIBILITY_CHANGED |
string 在应用可见性发生变化(例如,HDMI 输入发生变化,或电视关闭或开启且 Cast 设备由外接电源)时触发。请注意,此 API 与浏览器引发的“webkitvisibilitychange”事件的效果相同。以 cast.framework.CastReceiverContext API 的形式提供此 API 是为了方便您执行操作以及避免依赖于带有 webkit 前缀的事件。 |
STANDBY_CHANGED |
string 在电视待机状态发生变化时触发。此事件与 cast.framework.system.EventType.VISIBILITY_CHANGED 事件相关,因为如果电视处于待机模式,则可见性将为 可见性状态比待机状态更精细(因为可见性状态还包括电视频道的选择),但并非在所有电视中都能可靠地检测到。在这些情况下,可以使用待机模式,因为大多数电视都实现了待机模式。 |
MAX_VIDEO_RESOLUTION_CHANGED |
string |
FEEDBACK_STARTED |
string 系统开始创建反馈报告时触发。 |
LaunchedFrom
string
表示启动接收器的请求类型。
值 |
|
---|---|
未知 |
string 无法确定发布负责人。 |
DIAL |
string 应用已由 DIAL 请求启动。 |
CAST |
string 应用由 Cast V2 请求启动。 |
云端 |
string 应用由 Google 助理请求(例如,通过 Google 助理指令)启动。 |
MessageType
string
自定义消息的类型。
值 |
|
---|---|
字符串 |
string 消息是自由格式的字符串。应用负责对传输的信息进行编码/解码。 |
JSON |
string 消息采用 JSON 编码。底层传输将使用 JSON 编码的字符串。 |
StandbyState
string
这表示平台报告的当前待机状态。如果 Cast 平台无法确定状态,则可能为 UNKNOWN
。
值 |
|
---|---|
待用 |
string |
NOT_STANDBY |
string |
未知 |
string |
SystemState
string
这表示当前的系统状态。
值 |
|
---|---|
NOT_STARTED |
string 尚未请求开始申请。 |
STARTING_IN_BACKGROUND |
string 应用正在启动,但用户看不到。 |
正在启动 |
string 应用正在启动。 |
准备就绪 |
string 应用位于前台,已准备好收发消息。 |
STOPPING_IN_BACKGROUND |
string 应用正在后台停止运行。 |
正在停止 |
string 应用正在停止运行。 |
VisibilityState
string
这表示平台报告的当前可见性状态。如果 Cast 平台无法确定可见性状态,则可能为 UNKNOWN
。
值 |
|
---|---|
VISIBLE |
string |
NOT_VISIBLE |
string |
未知 |
string |