cast. framework. system
これは cast.framework.system Namespace です。
クラス
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
文字列
キャスト対応デバイスと、該当する場合は接続先のディスプレイ デバイスで構成される現在のセットアップの機能について説明します。
値 |
|
|---|---|
|
AUDIO_ASSISTANT |
文字列 音声アシスタントのサポート。音声アシスタントに対応した Cast 対応デバイスの例としては、Google Home や Google Home Mini などがあります。 |
|
BLUETOOTH_SUPPORTED |
文字列 Bluetooth のサポート。 |
|
DISPLAY_SUPPORTED |
文字列 ディスプレイ出力のサポート。ディスプレイをサポートする Cast 対応デバイスの例としては、Chromecast や Cast 対応テレビがあります。ディスプレイに対応していない Cast 対応デバイスの例としては、Chromecast Audio や Google Home などがあります。 |
|
HI_RES_AUDIO_SUPPORTED |
文字列 ハイレゾ オーディオ(最大 24 ビット / 96 KHz)をサポート。 |
|
IS_DV_SUPPORTED |
文字列 ドルビー ビジョンのサポート。 |
|
IS_HDR_SUPPORTED |
文字列 HDR 動画のサポート。 |
|
CAST_LITE_ONLY |
文字列 このデバイスが音声のみのプラットフォームで実行されているかどうか。一部の API は、このようなプラットフォームで完全にサポートされていない可能性があります。 |
|
DPAD_INPUT_SUPPORTED |
文字列 このデバイスが、ロック解除用方向キーなどの入力メカニズムをサポートしているかどうか。 |
|
TOUCH_INPUT_SUPPORTED |
文字列 タッチ入力のサポート。タッチ入力に対応している Cast 対応デバイスの例としては、Google Nest Hub や Google Nest Hub Max などがあります。 |
|
IS_GROUP |
文字列 デバイスが仮想デバイスで、物理デバイスではなくグループ ターゲットを表している場合。 |
|
IS_DEVICE_REGISTERED |
文字列
|
|
IS_CBCS_SUPPORTED |
文字列
|
|
IS_DOLBY_ATMOS_SUPPORTED |
文字列
|
DeviceInformation
文字列
cast.framework.CastReceiverContext.DeviceInformationObj の有効なキーの定数。
値 |
|
|---|---|
|
MODEL_NAME |
文字列 デバイスモデルの名前(Google TV Streamer、Google Nest Hub、Google 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 Receiver ID と同じ値になります。不明な場合は空白の文字列。 |
|
METADATA_FROM_FIRMWARE |
文字列 デバイス情報がファームウェアによって提供されたかどうか。 |
DisconnectReason
文字列
切断の理由を表します。
値 |
|
|---|---|
|
REQUESTED_BY_SENDER |
文字列 接続の終了が送信側アプリから積極的にリクエストされた(通常はユーザーによってトリガーされる)。 |
|
エラー |
文字列 プロトコル エラーが発生しました。 |
|
不明 |
文字列 送信側が |
EventType
文字列
cast.framework.CastReceiverContext によってディスパッチされるシステム イベント。
値 |
|
|---|---|
|
準備完了 |
文字列 システムが準備完了したときに発火します。 |
|
シャットダウン |
文字列 アプリケーションが終了すると呼び出されます。 |
|
SENDER_CONNECTED |
文字列 新しい送信者が接続されたときに発生します。 |
|
SENDER_DISCONNECTED |
文字列 送信者が切断されたときに呼び出されます。 |
|
エラー |
文字列 システムエラーが発生すると呼び出されます。 |
|
SYSTEM_VOLUME_CHANGED |
文字列 システム音量が変更されたときに発生します。 |
|
VISIBILITY_CHANGED |
文字列 アプリの可視性が変更されたとき(HDMI 入力の変更後や、テレビのオン / オフ時、キャスト デバイスが外部電源で動作しているときなど)に発生します。この API は、ブラウザによって発生する webkitvisibilitychange イベントと同じ効果があります。これは、便宜上、また webkit プレフィックス付きイベントへの依存を避けるために、cast.framework.CastReceiverContext API として提供されます。 |
|
STANDBY_CHANGED |
文字列 テレビのスタンバイ状態が変更されたときに発生します。このイベントは cast.framework.system.EventType.VISIBILITY_CHANGED イベントに関連しています。テレビがスタンバイ モードの場合、可視性は 可視性状態はスタンバイ状態よりも細かく(可視性にはテレビチャンネルの選択も含まれるため)なりますが、すべてのテレビで確実に検出されるわけではありません。ほとんどのテレビでスタンバイが実装されているため、このような場合はスタンバイを使用できます。 |
|
MAX_VIDEO_RESOLUTION_CHANGED |
文字列 |
|
FEEDBACK_STARTED |
文字列 システムがフィードバック レポートの作成を開始したときに呼び出されます。 |
LaunchedFrom
文字列
これは、レシーバーを起動したリクエストのタイプを表します。
値 |
|
|---|---|
|
不明 |
文字列 リリース オーナーを特定できませんでした。 |
|
DIAL |
文字列 アプリが DIAL リクエストによって起動された。 |
|
CAST |
文字列 アプリが Cast V2 リクエストによって起動された。 |
|
Cloud |
文字列 アシスタント リクエスト(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
文字列
キャスト対応デバイスと、該当する場合は接続先のディスプレイ デバイスで構成される現在のセットアップの機能について説明します。
値 |
|
|---|---|
|
AUDIO_ASSISTANT |
文字列 音声アシスタントのサポート。音声アシスタントに対応した Cast 対応デバイスの例としては、Google Home や Google Home Mini などがあります。 |
|
BLUETOOTH_SUPPORTED |
文字列 Bluetooth のサポート。 |
|
DISPLAY_SUPPORTED |
文字列 ディスプレイ出力のサポート。ディスプレイをサポートする Cast 対応デバイスの例としては、Chromecast や Cast 対応テレビがあります。ディスプレイに対応していない Cast 対応デバイスの例としては、Chromecast Audio や Google Home などがあります。 |
|
HI_RES_AUDIO_SUPPORTED |
文字列 ハイレゾ オーディオ(最大 24 ビット / 96 KHz)をサポート。 |
|
IS_DV_SUPPORTED |
文字列 ドルビー ビジョンのサポート。 |
|
IS_HDR_SUPPORTED |
文字列 HDR 動画のサポート。 |
|
CAST_LITE_ONLY |
文字列 このデバイスが音声のみのプラットフォームで実行されているかどうか。一部の API は、このようなプラットフォームで完全にサポートされていない可能性があります。 |
|
DPAD_INPUT_SUPPORTED |
文字列 このデバイスが、ロック解除用方向キーなどの入力メカニズムをサポートしているかどうか。 |
|
TOUCH_INPUT_SUPPORTED |
文字列 タッチ入力のサポート。タッチ入力に対応している Cast 対応デバイスの例としては、Google Nest Hub や Google Nest Hub Max などがあります。 |
|
IS_GROUP |
文字列 デバイスが仮想デバイスで、物理デバイスではなくグループ ターゲットを表している場合。 |
|
IS_DEVICE_REGISTERED |
文字列
|
|
IS_CBCS_SUPPORTED |
文字列
|
|
IS_DOLBY_ATMOS_SUPPORTED |
文字列
|
DeviceInformation
文字列
cast.framework.CastReceiverContext.DeviceInformationObj の有効なキーの定数。
値 |
|
|---|---|
|
MODEL_NAME |
文字列 デバイスモデルの名前(Google TV Streamer、Google Nest Hub、Google 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 Receiver ID と同じ値になります。不明な場合は空白の文字列。 |
|
METADATA_FROM_FIRMWARE |
文字列 デバイス情報がファームウェアによって提供されたかどうか。 |
DisconnectReason
文字列
切断の理由を表します。
値 |
|
|---|---|
|
REQUESTED_BY_SENDER |
文字列 接続の終了が送信側アプリから積極的にリクエストされた(通常はユーザーによってトリガーされる)。 |
|
エラー |
文字列 プロトコル エラーが発生しました。 |
|
不明 |
文字列 送信側が |
EventType
文字列
cast.framework.CastReceiverContext によってディスパッチされるシステム イベント。
値 |
|
|---|---|
|
準備完了 |
文字列 システムが準備完了したときに発火します。 |
|
シャットダウン |
文字列 アプリケーションが終了すると呼び出されます。 |
|
SENDER_CONNECTED |
文字列 新しい送信者が接続されたときに発生します。 |
|
SENDER_DISCONNECTED |
文字列 送信者が切断されたときに呼び出されます。 |
|
エラー |
文字列 システムエラーが発生すると呼び出されます。 |
|
SYSTEM_VOLUME_CHANGED |
文字列 システム音量が変更されたときに発生します。 |
|
VISIBILITY_CHANGED |
文字列 アプリの可視性が変更されたとき(HDMI 入力の変更後や、テレビのオン / オフ時、キャスト デバイスが外部電源で動作しているときなど)に発生します。この API は、ブラウザによって発生する webkitvisibilitychange イベントと同じ効果があります。これは、便宜上、また webkit プレフィックス付きイベントへの依存を避けるために、cast.framework.CastReceiverContext API として提供されます。 |
|
STANDBY_CHANGED |
文字列 テレビのスタンバイ状態が変更されたときに発生します。このイベントは cast.framework.system.EventType.VISIBILITY_CHANGED イベントに関連しています。テレビがスタンバイ モードの場合、可視性は 可視性状態はスタンバイ状態よりも細かく(可視性にはテレビチャンネルの選択も含まれるため)なりますが、すべてのテレビで確実に検出されるわけではありません。ほとんどのテレビでスタンバイが実装されているため、このような場合はスタンバイを使用できます。 |
|
MAX_VIDEO_RESOLUTION_CHANGED |
文字列 |
|
FEEDBACK_STARTED |
文字列 システムがフィードバック レポートの作成を開始したときに呼び出されます。 |
LaunchedFrom
文字列
これは、レシーバーを起動したリクエストのタイプを表します。
値 |
|
|---|---|
|
不明 |
文字列 リリース オーナーを特定できませんでした。 |
|
DIAL |
文字列 アプリが DIAL リクエストによって起動された。 |
|
CAST |
文字列 アプリが Cast V2 リクエストによって起動された。 |
|
Cloud |
文字列 アシスタント リクエスト(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 |
文字列 |
|
不明 |
文字列 |
抽象型
DeviceCapabilitiesObj
{audio_assistant:(ブール値または未定義)、bluetooth_supported:(ブール値または未定義)、display_supported:(ブール値または未定義)、hi_res_audio_supported:(ブール値または未定義)、is_dv_supported:(ブール値または未定義)、is_hdr_supported:(ブール値または未定義)、cast_lite_only:(ブール値または未定義)、dpad_input_supported:(ブール値または未定義)、touch_input_supported:(ブール値または未定義)、is_group:(ブール値または未定義)、remote_control_overlay_supported:(ブール値または未定義)、sleep_timer_overlay_supported:(ブール値または未定義)、app_foreground:(ブール値または未定義)、is_device_registered:(ブール値または未定義)、is_cbcs_supported:(ブール値または未定義)、is_dolby_atmos_supported:(ブール値または未定義)}
getDeviceCapabilities によって返されるオブジェクトについて説明します
DeviceInformationObj
{model-name: string, brand-name: string, os-name: string, os-version: string, environment: string, device-id: string, metadata-from-firmware: boolean}
getDeviceInformation から返されるオブジェクトについて説明します