命名空間：系統

cast. 架構.系統

namespace static

這是 cast.framework.system 命名空間。

類別

列舉

裝置功能

靜態

string

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

值

音訊

string

支援語音助理。支援 Google 助理的 Cast 裝置包括 Google Home 和 Google Home Mini。

BLUETOOTH_SUPPORTED

string

支援藍牙。

DISPLAY_SUPPORTED

string

顯示輸出支援。支援投放功能的支援 Cast 裝置的範例包括 Chromecast 和投放電視。舉例來說，支援 Cast 的裝置不支援 Chromecast Audio 和 Google Home。

HI_RES_AUDIO_SUPPORTED

string

支援高解析度音訊 (最高 24 位元 / 96KHz)。

IS_DV_SUPPORTED

string

支援 Dolby Vision。

支援範圍：IS_HDR_SUPPORTED

string

支援 HDR 影片。

《TOUCH_INPUT_SUPPORTED》

string

支援觸控輸入。支援觸控輸入功能的支援 Cast 裝置包括 Google Nest Hub 和 Google Nest Hub Max。

IS_GROUP

string

如果裝置是虛擬裝置，且代表群組目標，而不是實體裝置。

已解鎖裝置

string

設為 true 後，這個標記表示 Cast 裝置已在 Cast Developer Console 中註冊

支援範圍：IS_CBCS_SUPPORTED

string

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

IS_DOLBY_ATMOS_SUPPORTED

string

設為 true 時，這個標記表示透過音訊傳輸支援 Dolby Atmos。

中斷連線原因

靜態

string

代表中斷連線的原因。

值

REQUESTED_BY_SENDER

string

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

錯誤

string

發生通訊協定錯誤。

不明

string

如果傳送者呼叫 close() 並安全地中斷連線，可能是因為不明，但「close」訊息可能已遺失。這通常是發生網路逾時、寄件者應用程式當機或寄件者 OS 關閉通訊端時。

EventType

靜態

string

cast.framework.CastReceiverContext 調派的系統事件。

值

準備就緒

string

系統就緒時觸發。

SHUTDOWN

string

應用程式終止時觸發。

SENDER_CONNECTED

string

有新的寄件者連線時觸發。

SENDER_DISCONNECTED

string

寄件者中斷連線時觸發。

錯誤

string

發生系統錯誤時觸發。

SYSTEM_VOLUME_CHANGED (已調整)

string

系統音量變更時觸發。

VISIBILITY_CHANGED

string

在應用程式瀏覽權限變更時觸發 (例如，於 HDMI 輸入後變更、電視關閉或開啟，且投放裝置是外部電源時)請注意，這個 API 與瀏覽器產生的「webkitvisibilitychange」事件的作用相同。作為 cast.framework.CastReceiverContext API 的提供。

STANDBY_CHANGED

string

電視待機狀態變更時觸發。這個事件與 cast.framework.system.EventType.VISIBILITY_CHANGED 事件有關，因為如果電視處於待機模式，瀏覽權限將會是 false。

瀏覽權限狀態比待命狀態更精細 (因為瀏覽權限也包括電視頻道選項)，但在所有電視上皆無法穩定偵測到。因為大部分的電視都可實作待命模式，所以在此同時也能使用待命模式。

MAX_VIDEO_RESOLUTION_CHANGED

string

資訊提供 BACK_STARTED

string

系統開始建立意見回饋報告時觸發。

啟動來源

靜態

string

這是指啟動接收器的類型。

值

不明

string

無法確定啟用者。

撥號

string

應用程式是透過 DIAL 要求啟動。

投放

string

應用程式是由 Cast V2 要求啟動。

雲端

string

應用程式已透過 Google 助理指令 (例如 Google 助理指令) 啟動。

MessageType

靜態

string

自訂訊息的類型。

值

STRING

string

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

JSON

string

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

待命狀態

靜態

string

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

值

待命

string

NOT_STANDBY

string

不明

string

系統狀態

靜態

string

這代表目前的系統狀態。

值

非_STARTED

string

尚未要求應用程式啟動。

STARTING_IN_BACKGROUND

string

應用程式正在啟動，但使用者看不到。

啟動中

string

正在啟動應用程式。

準備就緒

string

應用程式位於前景，並可收發訊息。

STOPPING_IN_BACKGROUND

string

應用程式在背景執行時停止運作。

停止中

string

應用程式已停止執行。

瀏覽權限狀態

靜態

string

代表平台回報目前的顯示設定狀態。如果 Cast 平台無法判斷瀏覽權限狀態，則會顯示 UNKNOWN。

值

VISIBLE

string

NOT_VISIBLE

string

不明

string

屬性

裝置功能

靜態

string

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

值

音訊

string

支援語音助理。支援 Google 助理的 Cast 裝置包括 Google Home 和 Google Home Mini。

BLUETOOTH_SUPPORTED

string

支援藍牙。

DISPLAY_SUPPORTED

string

顯示輸出支援。支援投放功能的支援 Cast 裝置的範例包括 Chromecast 和投放電視。舉例來說，支援 Cast 的裝置不支援 Chromecast Audio 和 Google Home。

HI_RES_AUDIO_SUPPORTED

string

支援高解析度音訊 (最高 24 位元 / 96KHz)。

IS_DV_SUPPORTED

string

支援 Dolby Vision。

支援範圍：IS_HDR_SUPPORTED

string

支援 HDR 影片。

《TOUCH_INPUT_SUPPORTED》

string

支援觸控輸入。支援觸控輸入功能的支援 Cast 裝置包括 Google Nest Hub 和 Google Nest Hub Max。

IS_GROUP

string

如果裝置是虛擬裝置，且代表群組目標，而不是實體裝置。

已解鎖裝置

string

設為 true 後，這個標記表示 Cast 裝置已在 Cast Developer Console 中註冊

支援範圍：IS_CBCS_SUPPORTED

string

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

IS_DOLBY_ATMOS_SUPPORTED

string

設為 true 時，這個標記表示透過音訊傳輸支援 Dolby Atmos。

中斷連線原因

靜態

string

代表中斷連線的原因。

值

REQUESTED_BY_SENDER

string

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

錯誤

string

發生通訊協定錯誤。

不明

string

如果傳送者呼叫 close() 並安全地中斷連線，可能是因為不明，但「close」訊息可能已遺失。這通常是發生網路逾時、寄件者應用程式當機或寄件者 OS 關閉通訊端時。

EventType

靜態

string

cast.framework.CastReceiverContext 調派的系統事件。

值

準備就緒

string

系統就緒時觸發。

SHUTDOWN

string

應用程式終止時觸發。

SENDER_CONNECTED

string

有新的寄件者連線時觸發。

SENDER_DISCONNECTED

string

寄件者中斷連線時觸發。

錯誤

string

發生系統錯誤時觸發。

SYSTEM_VOLUME_CHANGED (已調整)

string

系統音量變更時觸發。

VISIBILITY_CHANGED

string

在應用程式瀏覽權限變更時觸發 (例如，於 HDMI 輸入後變更、電視關閉或開啟，且投放裝置是外部電源時)請注意，這個 API 與瀏覽器產生的「webkitvisibilitychange」事件的作用相同。作為 cast.framework.CastReceiverContext API 的提供。

STANDBY_CHANGED

string

電視待機狀態變更時觸發。這個事件與 cast.framework.system.EventType.VISIBILITY_CHANGED 事件有關，因為如果電視處於待機模式，瀏覽權限將會是 false。

瀏覽權限狀態比待命狀態更精細 (因為瀏覽權限也包括電視頻道選項)，但在所有電視上皆無法穩定偵測到。因為大部分的電視都可實作待命模式，所以在此同時也能使用待命模式。

MAX_VIDEO_RESOLUTION_CHANGED

string

資訊提供 BACK_STARTED

string

系統開始建立意見回饋報告時觸發。

啟動來源

靜態

string

這是指啟動接收器的類型。

值

不明

string

無法確定啟用者。

撥號

string

應用程式是透過 DIAL 要求啟動。

投放

string

應用程式是由 Cast V2 要求啟動。

雲端

string

應用程式已透過 Google 助理指令 (例如 Google 助理指令) 啟動。

MessageType

靜態

string

自訂訊息的類型。

值

STRING

string

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

JSON

string

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

待命狀態

靜態

string

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

值

待命

string

NOT_STANDBY

string

不明

string

系統狀態

靜態

string

這代表目前的系統狀態。

值

非_STARTED

string

尚未要求應用程式啟動。

STARTING_IN_BACKGROUND

string

應用程式正在啟動，但使用者看不到。

啟動中

string

正在啟動應用程式。

準備就緒

string

應用程式位於前景，並可收發訊息。

STOPPING_IN_BACKGROUND

string

應用程式在背景執行時停止運作。

停止中

string

應用程式已停止執行。

瀏覽權限狀態

靜態

string

代表平台回報目前的顯示設定狀態。如果 Cast 平台無法判斷瀏覽權限狀態，則會顯示 UNKNOWN。

值

VISIBLE

string

NOT_VISIBLE

string

不明

string