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
字串
說明目前設定的功能,這是由支援 Cast 的裝置和目前連接的顯示裝置組成 (如適用)。
值 |
|
---|---|
AUDIO_ASSISTANT |
字串 音訊助理支援。支援音訊助理且支援 Cast 的裝置包括 Google Home 和 Google Home Mini。 |
BLUETOOTH_SUPPORTED |
字串 支援藍牙。 |
DISPLAY_SUPPORTED |
字串 顯示輸出支援。例如 Chromecast 和投放電視支援支援 Cast 的裝置。舉例來說,Chromecast Audio 和 Google Home 等支援 Cast 的裝置都不支援螢幕。 |
HI_RES_AUDIO_SUPPORTED |
字串 支援高解析度音訊 (最高 24 位元 / 96KHz)。 |
IS_DV_SUPPORTED |
字串 支援 Dolby Vision。 |
IS_HDR_SUPPORTED |
字串 支援 HDR 影片。 |
TOUCH_INPUT_SUPPORTED |
字串 支援觸控輸入。舉例來說,Google Nest Hub 和 Google Nest Hub Max 支援觸控輸入功能,例如 Google Nest Hub 和 Google Nest Hub Max。 |
IS_GROUP |
字串 如果裝置是虛擬裝置,且代表群組目標,而非實體裝置。 |
IS_DEVICE_REGISTERED |
字串 設為 |
IS_CBCS_SUPPORTED |
字串 設為 |
IS_DOLBY_ATMOS_SUPPORTED |
字串 設為 |
DisconnectReason
字串
代表連線中斷的原因。
值 |
|
---|---|
REQUESTED_BY_SENDER |
字串 傳送者應用程式已主動要求關閉連線 (通常由使用者觸發)。 |
錯誤 |
字串 發生通訊協定錯誤。 |
不明 |
字串 如果傳送方要求呼叫 |
EventType
字串
由 cast.framework.CastReceiverContext 分派的系統事件。
值 |
|
---|---|
準備就緒 |
字串 系統準備就緒時觸發。 |
SHUTDOWN |
字串 應用程式終止時觸發。 |
SENDER_CONNECTED |
字串 新的傳送者連線時觸發。 |
SENDER_DISCONNECTED |
字串 在傳送者中斷連線時觸發。 |
錯誤 |
字串 發生系統錯誤時觸發。 |
SYSTEM_VOLUME_CHANGED |
字串 系統音量變更時觸發。 |
VISIBILITY_CHANGED |
字串 應用程式的瀏覽權限變更時 (例如 HDMI 輸入變更,或電視關閉/開啟,且投放裝置由外部供電時觸發)。請注意,這個 API 的效果與瀏覽器引發的「webkitvisibilitychange」事件相同。這裡提供的是 cast.framework.CastReceiverContext API,這是為方便起見而提供的,可避免對以 Webkit 開頭的事件依賴。 |
STANDBY_CHANGED |
字串 電視的待機狀態變更時觸發。此事件與 cast.framework.system.EventType.VISIBILITY_CHANGED 事件相關,因為當電視處於待機模式時,瀏覽權限為 瀏覽權限狀態比待命狀態更精細 (因為瀏覽權限也包括電視頻道選項),但並非所有電視都能穩定偵測到。由於大多數電視都會實作待命功能,因此可以在這類情況下使用。 |
MAX_VIDEO_RESOLUTION_CHANGED |
字串 |
FEEDBACK_STARTED |
字串 系統開始建立意見回饋報告時觸發。 |
LaunchedFrom
字串
這代表啟動了接收器的要求類型。
值 |
|
---|---|
不明 |
字串 無法判斷上市擁有者。 |
撥號 |
字串 應用程式是由 DIAL 要求啟動。 |
CAST |
字串 應用程式由 Cast V2 要求啟動。 |
雲端 |
字串 應用程式是由 Google 助理要求 (例如透過 Google 助理指令啟動) 啟動。 |
MessageType
字串
自訂訊息的類型。
值 |
|
---|---|
STRING |
字串 訊息是任意形式的字串。應用程式會負責對傳輸的資訊進行編碼/解碼。 |
JSON |
字串 訊息採用 JSON 編碼格式。基礎傳輸會使用 JSON 編碼字串。 |
StandbyState
字串
這代表平台回報目前的待機狀態。如果 Cast 平台無法判斷狀態,可能是 UNKNOWN
。
值 |
|
---|---|
待命 |
字串 |
NOT_STANDBY |
字串 |
不明 |
字串 |
SystemState
字串
這代表目前的系統狀態。
值 |
|
---|---|
NOT_STARTED |
字串 尚未收到啟動申請。 |
STARTING_IN_BACKGROUND |
字串 應用程式正在啟動,但使用者不會看到。 |
啟動中 |
字串 正在啟動應用程式。 |
準備就緒 |
字串 應用程式已在前景運作,準備收發訊息。 |
STOPPING_IN_BACKGROUND |
字串 應用程式在背景執行時停止。 |
停止中 |
字串 正在停止應用程式。 |
VisibilityState
字串
這代表平台目前回報的瀏覽權限狀態。如果 Cast 平台無法判斷瀏覽權限狀態,則可能是 UNKNOWN
。
值 |
|
---|---|
VISIBLE |
字串 |
NOT_VISIBLE |
字串 |
不明 |
字串 |
屬性
DeviceCapabilities
字串
說明目前設定的功能,這是由支援 Cast 的裝置和目前連接的顯示裝置組成 (如適用)。
值 |
|
---|---|
AUDIO_ASSISTANT |
字串 音訊助理支援。支援音訊助理且支援 Cast 的裝置包括 Google Home 和 Google Home Mini。 |
BLUETOOTH_SUPPORTED |
字串 支援藍牙。 |
DISPLAY_SUPPORTED |
字串 顯示輸出支援。例如 Chromecast 和投放電視支援支援 Cast 的裝置。舉例來說,Chromecast Audio 和 Google Home 等支援 Cast 的裝置都不支援螢幕。 |
HI_RES_AUDIO_SUPPORTED |
字串 支援高解析度音訊 (最高 24 位元 / 96KHz)。 |
IS_DV_SUPPORTED |
字串 支援 Dolby Vision。 |
IS_HDR_SUPPORTED |
字串 支援 HDR 影片。 |
TOUCH_INPUT_SUPPORTED |
字串 支援觸控輸入。舉例來說,Google Nest Hub 和 Google Nest Hub Max 支援觸控輸入功能,例如 Google Nest Hub 和 Google Nest Hub Max。 |
IS_GROUP |
字串 如果裝置是虛擬裝置,且代表群組目標,而非實體裝置。 |
IS_DEVICE_REGISTERED |
字串 設為 |
IS_CBCS_SUPPORTED |
字串 設為 |
IS_DOLBY_ATMOS_SUPPORTED |
字串 設為 |
DisconnectReason
字串
代表連線中斷的原因。
值 |
|
---|---|
REQUESTED_BY_SENDER |
字串 傳送者應用程式已主動要求關閉連線 (通常由使用者觸發)。 |
錯誤 |
字串 發生通訊協定錯誤。 |
不明 |
字串 如果傳送方要求呼叫 |
EventType
字串
由 cast.framework.CastReceiverContext 分派的系統事件。
值 |
|
---|---|
準備就緒 |
字串 系統準備就緒時觸發。 |
SHUTDOWN |
字串 應用程式終止時觸發。 |
SENDER_CONNECTED |
字串 新的傳送者連線時觸發。 |
SENDER_DISCONNECTED |
字串 在傳送者中斷連線時觸發。 |
錯誤 |
字串 發生系統錯誤時觸發。 |
SYSTEM_VOLUME_CHANGED |
字串 系統音量變更時觸發。 |
VISIBILITY_CHANGED |
字串 應用程式的瀏覽權限變更時 (例如 HDMI 輸入變更,或電視關閉/開啟,且投放裝置由外部供電時觸發)。請注意,這個 API 的效果與瀏覽器引發的「webkitvisibilitychange」事件相同。這裡提供的是 cast.framework.CastReceiverContext API,這是為方便起見而提供的,可避免對以 Webkit 開頭的事件依賴。 |
STANDBY_CHANGED |
字串 電視的待機狀態變更時觸發。此事件與 cast.framework.system.EventType.VISIBILITY_CHANGED 事件相關,因為當電視處於待機模式時,瀏覽權限為 瀏覽權限狀態比待命狀態更精細 (因為瀏覽權限也包括電視頻道選項),但並非所有電視都能穩定偵測到。由於大多數電視都會實作待命功能,因此可以在這類情況下使用。 |
MAX_VIDEO_RESOLUTION_CHANGED |
字串 |
FEEDBACK_STARTED |
字串 系統開始建立意見回饋報告時觸發。 |
LaunchedFrom
字串
這代表啟動了接收器的要求類型。
值 |
|
---|---|
不明 |
字串 無法判斷上市擁有者。 |
撥號 |
字串 應用程式是由 DIAL 要求啟動。 |
CAST |
字串 應用程式由 Cast V2 要求啟動。 |
雲端 |
字串 應用程式是由 Google 助理要求 (例如透過 Google 助理指令啟動) 啟動。 |
MessageType
字串
自訂訊息的類型。
值 |
|
---|---|
STRING |
字串 訊息是任意形式的字串。應用程式會負責對傳輸的資訊進行編碼/解碼。 |
JSON |
字串 訊息採用 JSON 編碼格式。基礎傳輸會使用 JSON 編碼字串。 |
StandbyState
字串
這代表平台回報目前的待機狀態。如果 Cast 平台無法判斷狀態,可能是 UNKNOWN
。
值 |
|
---|---|
待命 |
字串 |
NOT_STANDBY |
字串 |
不明 |
字串 |
SystemState
字串
這代表目前的系統狀態。
值 |
|
---|---|
NOT_STARTED |
字串 尚未收到啟動申請。 |
STARTING_IN_BACKGROUND |
字串 應用程式正在啟動,但使用者不會看到。 |
啟動中 |
字串 正在啟動應用程式。 |
準備就緒 |
字串 應用程式已在前景運作,準備收發訊息。 |
STOPPING_IN_BACKGROUND |
字串 應用程式在背景執行時停止。 |
停止中 |
字串 正在停止應用程式。 |
VisibilityState
字串
這代表平台目前回報的瀏覽權限狀態。如果 Cast 平台無法判斷瀏覽權限狀態,則可能是 UNKNOWN
。
值 |
|
---|---|
VISIBLE |
字串 |
NOT_VISIBLE |
字串 |
不明 |
字串 |