命名空間:系統

類別

列舉

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

字串

設為 true 時,這個標記表示投放裝置已在 Cast 開發人員控制台註冊

IS_CBCS_SUPPORTED

字串

設為 true 時,這個標記表示支援 CBCS 配置 (SAMPLE-AES)。

IS_DOLBY_ATMOS_SUPPORTED

字串

設為 true 時,這個標記表示支援透過音訊直通支援 Dolby Atmos。

DisconnectReason

靜態

字串

代表連線中斷的原因。

REQUESTED_BY_SENDER

字串

傳送者應用程式已主動要求關閉連線 (通常由使用者觸發)。

錯誤

字串

發生通訊協定錯誤。

不明

字串

如果傳送方要求呼叫 close() 以優雅中斷連線,表示會是不明的資訊 (很有可能沒有,但「close」訊息可能會遺失)。這通常發生在有網路逾時、傳送者應用程式當機,或傳送者作業系統關閉通訊端時。

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 事件相關,因為當電視處於待機模式時,瀏覽權限為 false

瀏覽權限狀態比待命狀態更精細 (因為瀏覽權限也包括電視頻道選項),但並非所有電視都能穩定偵測到。由於大多數電視都會實作待命功能,因此可以在這類情況下使用。

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

字串

設為 true 時,這個標記表示投放裝置已在 Cast 開發人員控制台註冊

IS_CBCS_SUPPORTED

字串

設為 true 時,這個標記表示支援 CBCS 配置 (SAMPLE-AES)。

IS_DOLBY_ATMOS_SUPPORTED

字串

設為 true 時,這個標記表示支援透過音訊直通支援 Dolby Atmos。

DisconnectReason

靜態

字串

代表連線中斷的原因。

REQUESTED_BY_SENDER

字串

傳送者應用程式已主動要求關閉連線 (通常由使用者觸發)。

錯誤

字串

發生通訊協定錯誤。

不明

字串

如果傳送方要求呼叫 close() 以優雅中斷連線,表示會是不明的資訊 (很有可能沒有,但「close」訊息可能會遺失)。這通常發生在有網路逾時、傳送者應用程式當機,或傳送者作業系統關閉通訊端時。

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 事件相關,因為當電視處於待機模式時,瀏覽權限為 false

瀏覽權限狀態比待命狀態更精細 (因為瀏覽權限也包括電視頻道選項),但並非所有電視都能穩定偵測到。由於大多數電視都會實作待命功能,因此可以在這類情況下使用。

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

字串

不明

字串