コマンド&コントロール(CaC)ツールは、ウェブ レシーバ アプリケーションのテストとデバッグを行うための、デベロッパー向けのウェブ センダーです。
デベロッパーは CaC ツールを使用して次のことを行えます。
- Cast 対応デバイスでウェブ レシーバー アプリを起動し、読み込みリクエストを送信してメディアの再生を開始します。
- Google アシスタントからウェブレシーバーに送信される音声コマンドをシミュレートします。
- Cast Debug Logger からログをキャプチャし、ウェブレシーバーのデバッグ オーバーレイを制御します。
Web Receiver アプリを起動する
CaC ツールでウェブレシーバーを起動する方法は 2 つあります。
新しいキャスト セッションを開始するには:
- CaC ツールを開き、ウェブレシーバー アプリ ID を入力して、[アプリ ID を設定] ボタンをクリックします。
キャスト アイコンをクリックし、デバイスを選択して、リモートの Cast 対応デバイスでウェブ レシーバーを起動します。
既存のキャスト セッションに参加するには:
実行中のキャスト セッション ID を取得するには、次のコードを使用します。
ウェブ レシーバー側で、Chrome リモート デバッガのコンソールから、次のメソッドでセッション ID を取得します。
cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;
または、接続されたウェブ送信者からセッション ID を取得するには、次のメソッドを使用します。
cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();
CaC ツールでセッション ID を入力して、[再開] ボタンをクリックします。
CaC ツールをウェブレシーバー アプリに接続すると、キャストされたフレームの形状がキャストボタンで表示されます。ツールの上部には、ウェブレシーバー アプリ ID とセッション ID も表示されます。
メディアを読み込む
送信者アプリまたは CaC ツールからメディアを読み込みます。
送信者アプリ
ウェブ レシーバでメディアの再生を開始するには、送信側アプリを同じ Cast 対応デバイスにキャストし、送信側アプリからウェブ受信側に読み込みリクエストを送信します。
CaC ツール
CaC ツールには、ウェブ レシーバー アプリに読み込みリクエストを送信する方法もいくつか用意されています。
エンティティごとに読み込む(音声キャスト)
ユーザーが Google アシスタントでメディアの再生を開始すると、Google アシスタントはコマンド アンド コントロール(CaC)メッセージを使用してユーザーの認証情報とエンティティをウェブレシーバーに送信します。
CaC ツールは音声キャストをシミュレートし、credentials
と entity
を使用して読み込みリクエストを送信します。
コンテンツごとに読み込む
CaC ツールは、Content ID
または Content Url
を使用して読み込みリクエストを送信するアプリをシミュレートすることもできます。
メディアの再生が開始されると、CaC ツールは Web Receiver アプリからメディア ステータス メッセージを受信して、[メディアのステータス] タブに表示します。
カスタム読み込みリクエスト
独自の Load Request
オブジェクトを使用してレシーバーをテストする場合は、[LOAD MEDIA] タブの [Custom Load Request] フィールドを使用します。まず、[リクエスト タイプを選択] ラジオボタンからリクエストの種類を選択し、独自の JSON オブジェクトをコピーして貼り付けるか、作成します。
音声コマンドをテストする
また、Google アシスタントからウェブレシーバー アプリに送信される音声コマンドもシミュレートします。アプリがサポートするメディア コマンドが正しく動作しているかどうかをテストできます。サポートされていないメディア コマンドは、適切なエラーの種類とエラーの理由で処理する必要があります。
Cast Debug Logger を調べて制御する
Web Receiver アプリで Cast Debug Logger が有効になっている場合、CaC ツールはログ メッセージをキャプチャし、Web Receiver デバッグ オーバーレイを制御します。
次のボタンを使用して、ウェブレシーバーとログメッセージを制御します。
- ウェブレシーバー アプリ ID
- キャッシュを消去してウェブレシーバーを停止する - ウェブレシーバー アプリを再読み込みしてキャストを停止します。
- ウェブレシーバー デバッグのオーバーレイ
- Show - Web Receiver のデバッグ オーバーレイを切り替える
- Clear - Web Receiver デバッグ オーバーレイのログメッセージを消去します。
- ログ メッセージ コントロール
- Insert Message - ログ領域にコメントまたは分割線を挿入します。
- ログをダウンロード - ログ メッセージを保存
- Clear Log - ログ領域のログメッセージを消去します。
- ログメッセージ
- カスタムタグ - ログメッセージをフィルタするチェックボックスをオンにします。
[カスタムタグ] に次のタグが表示されることがあります。これらは、デバッグ セッションに関連する重要なログやメッセージを表示およびフィルタリングするために、CaC ツールによって追加されます。
- メディア - Media 名前空間を介して正常に送信されたメッセージ
- MEDIA-ERROR - 送信中、または Media 名前空間経由で送信されたメッセージに応答してエラーが発生しました
- CAC - CAC 名前空間を介して正常に送信されたメッセージ
- CAC-ERROR - 送信中、または CAC 名前空間で送信されたメッセージへのレスポンスでエラーが発生しました。
- PLAYING - CaC ツールで [再生中の曲] ボタンをクリックしたときに結果を表示するログ
- USER - CaC ツールの [Insert Message] ボタンを使用してユーザーが入力したカスタム メッセージを表示するログ
Cast Connect をテストする
Cast Connect をテストするには、セッションを確立する前に次の手順を実施します。
- Cast Connect 対応レシーバーに関連付けられたレシーバー アプリ ID を入力し、[アプリ ID を設定] をクリックします。
- [Android TV オプションを表示] ボタンをクリックします。
- [androidReceiverCompatible] チェックボックスをオンにします。レシーバーが
Launch Credentials
を設定する必要がない場合、または設定されていない場合の影響をテストしたい場合は、ここで停止してステップ 5 に進むことができます。 - (省略可)
Launch Credentials
を入力して [起動認証情報を設定] ボタンをクリックし、Cast Connect セッションの起動認証情報を設定します。 - ヘッダーのキャスト アイコンをクリックするか、Chrome ブラウザのキャスト メニューを使用して、キャスト セッションを開始します。
これで Android TV アプリが起動します。