cast. 架構. 系統
這是 cast.framework.system
命名空間。
類別
應用程式資料
描述所啟動應用程式資料的中繼資料。
活動
cast.framework.CastReceiverContext 所納入的事件,其中包含系統資訊。
意見回饋開始活動
系統開始建立意見回饋報告時,由 cast.framework.CastReceiverContext 分派的事件。
「VideoVideoResolutionChangedEvent」
系統需要更新影片解析度上限時,由 cast.framework.CastReceiverContext 所發送的事件。
就緒事件
系統準備就緒時,由 cast.framework.CastReceiverContext 分派的事件。
寄件者
這代表已連線寄件者裝置的資料。
寄件者連線事件
連線時,cast.framework.CastReceiverContext 分派的事件。
寄件者中斷連線的事件
當傳送者中斷連線時,由 cast.framework.CastReceiverContext 分派的事件。
ShutdownEvent (關閉事件)
應用程式關閉時,由 cast.framework.CastReceiverContext 分派的事件。
StandbyChangedEvent
當電視進入或離開待機狀態時,由 cast.framework.CastReceiverContext 分派的事件,因此應用程式應一律驗證 isStandby
屬性。如要確認實際狀態不明,應用程式可以呼叫 cast.framework.CastReceiverContext#getStandbyState 方法。
SystemVolumeChangedEvent
系統音量變更時,由 cast.framework.CastReceiverContext 分派的事件。
SystemVolumeData
這代表系統磁碟區資料。
瀏覽權限已變更
cast.framework.CastReceiverContext 由應用程式顯示設定變更時 (例如 HDMI 輸入變更或電視關閉時) 分派的事件。
列舉
裝置功能
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 設為 |
支援範圍:IS_CBCS_SUPPORTED |
string 這個標記設為 |
IS_DOLBY_ATMOS_SUPPORTED |
string 設為 |
中斷連線原因
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 輸入後變更、電視關閉或開啟,且投放裝置是外部電源時)請注意,這個 API 與瀏覽器產生的「webkitvisibilitychange」事件的作用相同。作為 cast.framework.CastReceiverContext API 的提供。 |
STANDBY_CHANGED |
string 電視待機狀態變更時觸發。這個事件與 cast.framework.system.EventType.VISIBILITY_CHANGED 事件有關,因為如果電視處於待機模式,瀏覽權限將會是 瀏覽權限狀態比待命狀態更精細 (因為瀏覽權限也包括電視頻道選項),但在所有電視上皆無法穩定偵測到。因為大部分的電視都可實作待命模式,所以在此同時也能使用待命模式。 |
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 設為 |
支援範圍:IS_CBCS_SUPPORTED |
string 這個標記設為 |
IS_DOLBY_ATMOS_SUPPORTED |
string 設為 |
中斷連線原因
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 輸入後變更、電視關閉或開啟,且投放裝置是外部電源時)請注意,這個 API 與瀏覽器產生的「webkitvisibilitychange」事件的作用相同。作為 cast.framework.CastReceiverContext API 的提供。 |
STANDBY_CHANGED |
string 電視待機狀態變更時觸發。這個事件與 cast.framework.system.EventType.VISIBILITY_CHANGED 事件有關,因為如果電視處於待機模式,瀏覽權限將會是 瀏覽權限狀態比待命狀態更精細 (因為瀏覽權限也包括電視頻道選項),但在所有電視上皆無法穩定偵測到。因為大部分的電視都可實作待命模式,所以在此同時也能使用待命模式。 |
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 |