當電視進入或離開待機狀態時，cast.framework.CastReceiverContext 會調度事件，因此應用程式應一律驗證 isStandby 屬性。如要確認實際狀態是否不明，應用程式可以呼叫 cast.framework.CastReceiverContext#getStandbyState 方法。

SystemVolumeChangedEvent

系統音量變更時，由 cast.framework.CastReceiverContext 傳送的事件。

VisibilityChangedEvent

當應用程式的顯示設定變更時 (例如 HDMI 輸入變更或電視關閉)，cast.framework.CastReceiverContext 會調度事件。

列舉

DeviceCapabilities

static

字串

說明目前設定的功能，包括支援 Cast 的裝置，以及所連接的顯示裝置 (如適用)。

值
AUDIO_ASSISTANT	字串音訊助理支援。支援 Cast 的音訊助理裝置包括 Google Home 和 Google Home Mini。
BLUETOOTH_SUPPORTED	字串藍牙支援。
DISPLAY_SUPPORTED	字串支援顯示輸出。支援 Cast 且支援螢幕的裝置包括 Chromecast 和 Cast 電視。不支援螢幕的支援 Cast 裝置包括 Chromecast Audio 和 Google Home。
HI_RES_AUDIO_SUPPORTED	字串支援高解析度音訊 (最高 24 位元/96KHz)。
IS_DV_SUPPORTED	字串支援 Dolby Vision。
IS_HDR_SUPPORTED	字串支援 HDR 影片。
CAST_LITE_ONLY	字串這部裝置是否在純音訊平台上執行。這類平台可能不完全支援某些 API。
DPAD_INPUT_SUPPORTED	字串這部裝置是否支援輸入機制，例如解鎖 DPAD。
TOUCH_INPUT_SUPPORTED	字串支援觸控輸入。支援觸控輸入的 Cast 裝置包括 Google Nest Hub 和 Google Nest Hub Max。
IS_GROUP	字串如果裝置是虛擬裝置，且代表群組目標，而非實體裝置。
IS_DEVICE_REGISTERED	字串如果設為 `true`，這個旗標表示 Cast 裝置已在 Cast 開發人員控制台中註冊
IS_CBCS_SUPPORTED	字串設為 `true` 時，這個旗標表示支援 CBCS 配置 (SAMPLE-AES)。
IS_DOLBY_ATMOS_SUPPORTED	字串設為 `true` 時，這個標記表示支援透過音訊直通播放 Dolby Atmos。

DeviceInformation

static

字串

cast.framework.CastReceiverContext.DeviceInformationObj 中有效鍵的常數。

值
MODEL_NAME	字串裝置型號名稱 (例如 Google TV Streamer、Nest Hub、Nest Mini 等)，如已知。如果不知道，則為「unknown」。
BRAND_NAME	字串裝置品牌名稱 (例如 Google、LG、Sony 等)，如果已知的話。如果不知道，則為空白字串。
OS_NAME	字串裝置 OS 的名稱 (例如 Android、Fuchsia、Linux 等)，如果已知的話。如果未知，則為空白字串；如果不是 Cast 裝置，則為「not Cast」。
OS_VERSION	字串裝置 OS 版本 (例如 14.0 等)，如已知。如果不知道，則為空白字串。
環境	字串裝置所在的環境類型 (例如住家、汽車、飛機、飯店等)，如已知。大多數裝置通常會顯示「首頁」。
DEVICE_ID	字串接收端裝置的專屬 ID (如有)。這個值會與 Sender SDK 公開的 Cast 接收端 ID 相同。如果不知道，則為空白字串。
METADATA_FROM_FIRMWARE	字串裝置資訊是否由韌體提供。

DisconnectReason

static

字串

代表中斷連線的原因。

值
REQUESTED_BY_SENDER	字串傳送端應用程式主動要求關閉連線 (通常由使用者觸發)。
錯誤	字串發生通訊協定錯誤。
不明	字串目前無法得知傳送者是否透過呼叫 `close()` 要求正常中斷連線 (最有可能的情況是沒有，但「close」訊息可能已遺失)。這通常發生在網路逾時、傳送端應用程式異常終止，或傳送端 OS 關閉通訊端時。
APPLICATION_STOP	字串接收端應用程式已自行停止。
ABRUPT_SHUTDOWN	字串平台在傳送端仍連線時關閉應用程式。
NO_SENDERS	字串沒有傳送端連線時，應用程式會關閉。
TRANSPORT_CLOSED	字串基礎 SSL 通訊端由傳送者關閉，但未正常關閉虛擬連線。
TRANSPORT_ABORTED	字串基礎 SSL 通訊端已由對等端終止。
TRANSPORT_TOO_LONG_INACTIVE	字串由於心跳訊號失敗，基礎 SSL 通訊端已關閉。
CLOSED_BY_SELF	字串 Cast 接收端已正常關閉連線。

EventType

static

字串

由 cast.framework.CastReceiverContext 派送的系統事件。

值
準備就緒	字串系統準備就緒時觸發。
SHUTDOWN	字串在應用程式終止時觸發。
SENDER_CONNECTED	字串有新的傳送端連線時觸發。
SENDER_DISCONNECTED	字串在傳送端中斷連線時觸發。
錯誤	字串發生系統錯誤時觸發。
SYSTEM_VOLUME_CHANGED	字串系統音量變更時觸發。
VISIBILITY_CHANGED	字串在應用程式的顯示設定變更時觸發 (例如 HDMI 輸入變更後，或電視關閉或開啟，且 Cast 裝置由外部供電時)。請注意，這個 API 的效果與瀏覽器引發的「webkitvisibilitychange」事件相同。為方便起見，並避免依賴 webkit 前置字元事件，系統會以 cast.framework.CastReceiverContext API 的形式提供這項資訊。
STANDBY_CHANGED	字串電視的待機狀態變更時觸發。這項事件與 cast.framework.system.EventType.VISIBILITY_CHANGED 事件相關，因為如果電視處於待機模式，可見度會是 `false`。可見度狀態比待機狀態更精細 (因為可見度也包含電視頻道選擇)，但並非所有電視都能可靠地偵測到。在這種情況下，可以使用待機模式，因為大多數電視都支援這項功能。
MAX_VIDEO_RESOLUTION_CHANGED	字串
FEEDBACK_STARTED	字串系統開始建立意見回饋報告時觸發。

LaunchedFrom

static

字串

這代表啟動接收器的要求類型。

值
不明	字串無法判斷推出作業擁有者。
DIAL	字串應用程式是由 DIAL 要求啟動。
投放	字串應用程式是由 Cast V2 要求啟動。
雲端	字串應用程式是由 Google 助理要求啟動 (例如透過 Google 助理指令)。

MessageType

static

字串

自訂訊息類型。

值
STRING	字串訊息是任意形式的字串。應用程式負責對傳輸的資訊進行編碼/解碼。
JSON	字串訊息採用 JSON 編碼。基礎傳輸會使用 JSON 編碼字串。

值

STRING

字串

訊息是任意形式的字串。應用程式負責對傳輸的資訊進行編碼/解碼。

JSON

字串

訊息採用 JSON 編碼。基礎傳輸會使用 JSON 編碼字串。

StandbyState

static

字串

這代表平台回報的目前待機狀態。如果 Cast 平台無法判斷狀態，則可能是 UNKNOWN。

值
待機中	字串
NOT_STANDBY	字串
不明	字串

SystemState

static

字串

這代表目前的系統狀態。

值
NOT_STARTED	字串尚未要求啟動應用程式。
STARTING_IN_BACKGROUND	字串應用程式正在啟動，但使用者看不到。
啟動中	字串應用程式正在啟動。
準備就緒	字串應用程式位於前景，可收發訊息。
STOPPING_IN_BACKGROUND	字串應用程式在背景停止運作。
停止中	字串應用程式正在停止。

VisibilityState

static

字串

這代表平台回報的目前可見度狀態。如果 Cast 平台無法判斷顯示狀態，則可能為 UNKNOWN。

值
VISIBLE	字串
NOT_VISIBLE	字串
不明	字串

屬性

DeviceCapabilities

static

字串

說明目前設定的功能，包括支援 Cast 的裝置，以及所連接的顯示裝置 (如適用)。

值
AUDIO_ASSISTANT	字串音訊助理支援。支援 Cast 的音訊助理裝置包括 Google Home 和 Google Home Mini。
BLUETOOTH_SUPPORTED	字串藍牙支援。
DISPLAY_SUPPORTED	字串支援顯示輸出。支援 Cast 且支援螢幕的裝置包括 Chromecast 和 Cast 電視。不支援螢幕的支援 Cast 裝置包括 Chromecast Audio 和 Google Home。
HI_RES_AUDIO_SUPPORTED	字串支援高解析度音訊 (最高 24 位元/96KHz)。
IS_DV_SUPPORTED	字串支援 Dolby Vision。
IS_HDR_SUPPORTED	字串支援 HDR 影片。
CAST_LITE_ONLY	字串這部裝置是否在純音訊平台上執行。這類平台可能不完全支援某些 API。
DPAD_INPUT_SUPPORTED	字串這部裝置是否支援輸入機制，例如解鎖 DPAD。
TOUCH_INPUT_SUPPORTED	字串支援觸控輸入。支援觸控輸入的 Cast 裝置包括 Google Nest Hub 和 Google Nest Hub Max。
IS_GROUP	字串如果裝置是虛擬裝置，且代表群組目標，而非實體裝置。
IS_DEVICE_REGISTERED	字串如果設為 `true`，這個旗標表示 Cast 裝置已在 Cast 開發人員控制台中註冊
IS_CBCS_SUPPORTED	字串設為 `true` 時，這個旗標表示支援 CBCS 配置 (SAMPLE-AES)。
IS_DOLBY_ATMOS_SUPPORTED	字串設為 `true` 時，這個標記表示支援透過音訊直通播放 Dolby Atmos。

DeviceInformation

static

字串

cast.framework.CastReceiverContext.DeviceInformationObj 中有效鍵的常數。

值
MODEL_NAME	字串裝置型號名稱 (例如 Google TV Streamer、Nest Hub、Nest Mini 等)，如已知。如果不知道，則為「unknown」。
BRAND_NAME	字串裝置品牌名稱 (例如 Google、LG、Sony 等)，如果已知的話。如果不知道，則為空白字串。
OS_NAME	字串裝置 OS 的名稱 (例如 Android、Fuchsia、Linux 等)，如果已知的話。如果未知，則為空白字串；如果不是 Cast 裝置，則為「not Cast」。
OS_VERSION	字串裝置 OS 版本 (例如 14.0 等)，如已知。如果不知道，則為空白字串。
環境	字串裝置所在的環境類型 (例如住家、汽車、飛機、飯店等)，如已知。大多數裝置通常會顯示「首頁」。
DEVICE_ID	字串接收端裝置的專屬 ID (如有)。這個值會與 Sender SDK 公開的 Cast 接收端 ID 相同。如果不知道，則為空白字串。
METADATA_FROM_FIRMWARE	字串裝置資訊是否由韌體提供。

DisconnectReason

static

字串

代表中斷連線的原因。

值
REQUESTED_BY_SENDER	字串傳送端應用程式主動要求關閉連線 (通常由使用者觸發)。
錯誤	字串發生通訊協定錯誤。
不明	字串目前無法得知傳送者是否透過呼叫 `close()` 要求正常中斷連線 (最有可能的情況是沒有，但「close」訊息可能已遺失)。這通常發生在網路逾時、傳送端應用程式異常終止，或傳送端 OS 關閉通訊端時。
APPLICATION_STOP	字串接收端應用程式已自行停止。
ABRUPT_SHUTDOWN	字串平台在傳送端仍連線時關閉應用程式。
NO_SENDERS	字串沒有傳送端連線時，應用程式會關閉。
TRANSPORT_CLOSED	字串基礎 SSL 通訊端由傳送者關閉，但未正常關閉虛擬連線。
TRANSPORT_ABORTED	字串基礎 SSL 通訊端已由對等端終止。
TRANSPORT_TOO_LONG_INACTIVE	字串由於心跳訊號失敗，基礎 SSL 通訊端已關閉。
CLOSED_BY_SELF	字串 Cast 接收端已正常關閉連線。

EventType

static

字串

由 cast.framework.CastReceiverContext 派送的系統事件。

值
準備就緒	字串系統準備就緒時觸發。
SHUTDOWN	字串在應用程式終止時觸發。
SENDER_CONNECTED	字串有新的傳送端連線時觸發。
SENDER_DISCONNECTED	字串在傳送端中斷連線時觸發。
錯誤	字串發生系統錯誤時觸發。
SYSTEM_VOLUME_CHANGED	字串系統音量變更時觸發。
VISIBILITY_CHANGED	字串在應用程式的顯示設定變更時觸發 (例如 HDMI 輸入變更後，或電視關閉或開啟，且 Cast 裝置由外部供電時)。請注意，這個 API 的效果與瀏覽器引發的「webkitvisibilitychange」事件相同。為方便起見，並避免依賴 webkit 前置字元事件，系統會以 cast.framework.CastReceiverContext API 的形式提供這項資訊。
STANDBY_CHANGED	字串電視的待機狀態變更時觸發。這項事件與 cast.framework.system.EventType.VISIBILITY_CHANGED 事件相關，因為如果電視處於待機模式，可見度會是 `false`。可見度狀態比待機狀態更精細 (因為可見度也包含電視頻道選擇)，但並非所有電視都能可靠地偵測到。在這種情況下，可以使用待機模式，因為大多數電視都支援這項功能。
MAX_VIDEO_RESOLUTION_CHANGED	字串
FEEDBACK_STARTED	字串系統開始建立意見回饋報告時觸發。

LaunchedFrom

static

字串

這代表啟動接收器的要求類型。

值
不明	字串無法判斷推出作業擁有者。
DIAL	字串應用程式是由 DIAL 要求啟動。
投放	字串應用程式是由 Cast V2 要求啟動。
雲端	字串應用程式是由 Google 助理要求啟動 (例如透過 Google 助理指令)。

MessageType

static

字串

自訂訊息類型。

值
STRING	字串訊息是任意形式的字串。應用程式負責對傳輸的資訊進行編碼/解碼。
JSON	字串訊息採用 JSON 編碼。基礎傳輸會使用 JSON 編碼字串。

值

STRING

字串

訊息是任意形式的字串。應用程式負責對傳輸的資訊進行編碼/解碼。

JSON

字串

訊息採用 JSON 編碼。基礎傳輸會使用 JSON 編碼字串。

StandbyState

static

字串

這代表平台回報的目前待機狀態。如果 Cast 平台無法判斷狀態，則可能是 UNKNOWN。

值
待機中	字串
NOT_STANDBY	字串
不明	字串

SystemState

static

字串

這代表目前的系統狀態。

值
NOT_STARTED	字串尚未要求啟動應用程式。
STARTING_IN_BACKGROUND	字串應用程式正在啟動，但使用者看不到。
啟動中	字串應用程式正在啟動。
準備就緒	字串應用程式位於前景，可收發訊息。
STOPPING_IN_BACKGROUND	字串應用程式在背景停止運作。
停止中	字串應用程式正在停止。

VisibilityState

static

字串

這代表平台回報的目前可見度狀態。如果 Cast 平台無法判斷顯示狀態，則可能為 UNKNOWN。

值
VISIBLE	字串
NOT_VISIBLE	字串
不明	字串

抽象類型

DeviceCapabilitiesObj

static

{audio_assistant: (boolean or undefined), bluetooth_supported: (boolean or undefined), display_supported: (boolean or undefined), hi_res_audio_supported: (boolean or undefined), is_dv_supported: (boolean or undefined), is_hdr_supported: (boolean or undefined), cast_lite_only: (boolean or undefined), dpad_input_supported: (boolean or undefined), touch_input_supported: (boolean or undefined), is_group: (boolean or undefined), remote_control_overlay_supported: (boolean or undefined), sleep_timer_overlay_supported: (boolean or undefined), app_foreground: (boolean or undefined), is_device_registered: (boolean or undefined), is_cbcs_supported: (boolean or undefined), is_dolby_atmos_supported: (boolean or undefined)}

說明 getDeviceCapabilities 傳回的物件

另請參閱: cast.framework.system.DeviceCapabilities

DeviceInformationObj

static

{model-name: string, brand-name: string, os-name: string, os-version: string, environment: string, device-id: string, metadata-from-firmware: boolean}

說明 getDeviceInformation 傳回的物件

另請參閱: cast.framework.system.DeviceInformation

命名空間：系統 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

類別

列舉

DeviceCapabilities

值

DeviceInformation

值

DisconnectReason

值

EventType

值

LaunchedFrom

值

MessageType

值

StandbyState

值

SystemState

值

VisibilityState

值

屬性

DeviceCapabilities

值

DeviceInformation

值

DisconnectReason

值

EventType

值

LaunchedFrom

值

MessageType

值

StandbyState

值

SystemState

值

VisibilityState

值

抽象類型

DeviceCapabilitiesObj

DeviceInformationObj

命名空間：系統