スタイル付きメディア レシーバーを使用している場合、またはカスタム レシーバーを作成する場合は、アプリを登録する必要があります。アプリケーションを登録すると、アプリケーション ID が届きます。この ID は送信側アプリケーションが API 呼び出し(ウェブ レシーバー アプリケーションの起動など)を実行するために使用されます。
デフォルトのメディア レシーバーを使用する場合は、アプリを登録する必要はありません。デフォルトのメディア レシーバーでは、メディア プレーヤーの UI にスタイルを設定できません。指定された定数をアプリ ID として使用します。
また、Google Cast デバイスを登録して、公開前に Web Receiver アプリケーションにアクセスできるようにする必要があります。レシーバー アプリを公開すると、すべての Google Cast デバイスで利用できるようになります。
アプリケーション
アプリを登録すると、アプリを公開する前に、登録済みのキャスト デバイスでアプリをテストできるようになります。アプリを公開すると、すべてのキャスト デバイスで使用できるようになります。
アプリケーションを登録する
送信側アプリからの API 呼び出しで使用されるアプリケーション ID を受信するには、スタイル付きメディア レシーバーまたはカスタム レシーバーを登録する必要があります。
キャスト アプリを登録するには:
- Google Cast SDK Developer Console にログインします。
- [Overview] ページまたは [Applications] ページで、[Add New Application] をクリックします。
使用する Web Receiver アプリのタイプを選択します。
カスタム レシーバー
スタイル付きメディア レシーバーでは提供されないユーザー インターフェース コンポーネントや操作パターンがアプリに必要な場合は、このオプションを選択します。コンテンツ タイプがスタイル付きメディア レシーバーのサポートされているメディアタイプのリストに含まれていない場合も、カスタム レシーバーの選択が必要になることがあります。
このオプションでは、Web Receiver アプリ用の完全なウェブアプリを作成する必要があります。
詳細については、カスタム レシーバー アプリをご覧ください。
スタイル付きメディア レシーバー
アプリがサポートされているメディアタイプのいずれかを使用して動画や音声コンテンツをストリーミングし、デフォルトのメディア プレーヤー UI またはデフォルトのメディア プレーヤー UI の上に一連のカスタム スタイルを使用するユーザー インターフェースをテレビで提供する場合は、これを選択します。
カスタム スタイルを使用すると、CSS ファイルを提供するだけで、プレーヤー UI のさまざまな要素(スプラッシュ画面や進行状況バーなど)の外観を定義できます。レシーバー アプリを構築する必要はありません。
詳しくは、スタイル付きメディア レシーバーをご覧ください。
Web Receiver アプリの詳細を入力します。
[Name] フィールドにアプリ名を入力します。
これは、ウェブ レシーバーの読み込み時、またはスタイル付きメディア レシーバーを使用している場合はアイドル状態になったときに表示されるアプリ名です。カスタム レシーバーを使用している場合、このフィールドの値は、
setApplicationState
メソッドを使用して設定されていない場合、アプリの状態のデフォルト値になります。Web Receiver アプリの外観を指定します。
カスタム レシーバーの場合は、[URL] フィールドにアプリの URL を指定します。
Web Receiver アプリが読み込まれるときに Google Cast デバイスがリクエストする URL を入力します。開発時の URL には HTTP を使用できますが、アプリを公開する場合は HTTPS を使用する必要があります。たとえば、ウェブブラウザからアクセスできる HTML ページなどのファイル形式の URL を使用できます。ウェブレシーバーが内部(NAT 登録)IP アドレスにあっても問題ありませんが、ローカルホストはトップレベル ドメインになることがめったにないため、ローカル IP アドレスにはなりません。ウェブレシーバー アプリは公開時に SSL(HTTPS)経由で提供する必要がありますが、ウェブレシーバー アプリに読み込まれたコンテンツは HTTP 経由で提供できます。
スタイル付きメディア レシーバーの場合は、[Skin URL] フィールドにスタイルシートの URL を指定します。
ご自身のウェブサイトにある CSS ファイルを指す HTTPS URL を指定します。デフォルトのスタイルを使用する場合は、フィールドを空のままにします。カスタム スタイルを指定または更新する場合は、後でいつでも編集できます。
[Supports relay playing] チェックボックスをオンまたはオフにします。
リレー キャストにより、ウェブレシーバーは、レシーバーと同じ Wi-Fi ネットワークに接続されていないセンダーからのキャストをサポートできます。レシーバーでリレーキャストを無効にするには、このチェックボックスをオフにします。
[音声のみのデバイスへのキャストをサポートする] チェックボックスをオンまたはオフにします。
アプリがオーディオ機器用 Google Cast を検出できるようにするには、このチェックボックスをオンにします。音声のみのデバイスのサポートを無効にするには、このチェックボックスをオフにします。詳しくは、オーディオ機器をご覧ください。
[保存] をクリックします。
アプリケーション ID、名前、タイプ、ステータスなどの登録情報が表示されます。アプリケーション ID はアプリの Cast API 呼び出しで使用するため、メモしておきます。
[Done] をクリックして [Applications] ページに戻ります。
アプリケーション情報の編集
アプリを公開する前に、追加情報を提供する必要があります。登録時に提供したアプリケーション情報を更新することもできます。
応募情報を編集するには:
- Google Cast SDK Developer Console の [概要] ページまたは [アプリケーション] ページで、[アプリケーション ID] をクリックするか、編集するアプリの [編集] をクリックします。
- [名前] フィールドで、アプリケーションの登録時に指定した名前を更新します。
- カスタム レシーバー アプリケーションの場合は、[URL] フィールドで、登録したウェブ レシーバー アプリケーションの場所を更新します。
- スタイル付きレシーバー アプリの場合、[Skin URL] フィールドで、アプリのスタイルシートの場所を更新します。
[Supports relay playing] チェックボックスをオンまたはオフにします。
リレー キャストにより、ウェブレシーバーは、レシーバーと同じ Wi-Fi ネットワークに接続されていないセンダーからのキャストをサポートできます。レシーバーでリレーキャストを無効にするには、このチェックボックスをオフにします。
[音声のみのデバイスへのキャストをサポートする] チェックボックスをオンまたはオフにします。
アプリがオーディオ機器用 Google Cast を検出できるようにするには、このチェックボックスをオンにします。 音声のみのデバイスのサポートを無効にするには、このチェックボックスをオフにします。詳しくは、オーディオ機器をご覧ください。
[送信者の詳細] セクションで、アプリがサポートするプラットフォームごとに次の情報を入力します。
Android:
- アプリケーション パッケージの完全修飾名。
iOS:
- Apple で必要な iTunes ID とバンドル ID
- App Launch URI: Google Home アプリがアプリを起動するために使用する URI を使用します。必要な URI 形式について詳しくは、URL スキームを使用したアプリとの通信をご覧ください。
ウェブ:
- アプリケーションのウェブサイト URL です。
[Listing Details] セクションで、アプリを Google サービス(chromecast.com/apps. など)に表示するかどうかを選択します。
[カテゴリ] プルダウン メニューから、アプリケーションに最も適したカテゴリを選択します。
注: アプリは、他の設定によって暗黙的に示唆されるメディアタイプだけでなく、ここで説明するメディアタイプもサポートする必要があります。たとえば、アプリが音声用 Google Cast に対応している場合に、ここで [テレビ、映画] を選択する場合は、オーディオ機器に記載されている音声専用デバイスと、動画再生のプロビジョニングをサポートする必要があります。
アプリを利用できる国を説明するには、[すべての国] または [選択した国のみ] ラジオボタンを選択します。国を指定する場合は、表示されるリストで国のチェックボックスをオンにしてください。
[Title] フィールドに、アプリケーションのわかりやすいタイトルを入力します。
半角 50 文字(全角 25 文字)以内にしてください。例: 「YouTube」。
[Description] フィールドに、アプリケーションの説明を入力します。
半角 80 文字(全角 40 文字)以内にしてください。例: 「お気に入りの YouTube チャンネルを、ご自宅の最適な画面でお楽しみください。」
[Graphics] セクションで、プラス記号をクリックしてアプリのアイコン画像をアップロードします。
画像は 512 × 512 ピクセルで、背景は透明にする必要があります。
[Add Your Own Translations] で、[Title] フィールドと [Description] フィールドに翻訳を提供する場合は、プルダウン メニューから言語を選択し、[Add] をクリックして、表示されるダイアログで翻訳されたテキストを入力します。その翻訳に固有のアイコンの画像をアップロードすることもできます。
申請情報の更新が完了したら、[保存] をクリックします。
アプリケーションを発行
アプリを公開すると、世界中のすべてのキャスト デバイスでそのアプリを利用できるようになります。また、Google サービス(chromecast.com/apps 掲載サイトなど)にアプリの掲載情報も作成し、ユーザーがアプリを見つけてダウンロードできるようにします。上記の手順 6 でアプリ情報を編集したときにアプリを掲載するよう選択した場合は、公開後に chromecast.com/apps に表示されます。
アプリケーションを公開するには:
Google Cast SDK Developer Console の [概要] ページまたは [アプリケーション] ページで、公開するアプリの [公開] をクリックします。
アプリケーション情報の入力が完了すると、プレビュー画面に [Edit application information] で入力したアプリケーション情報が表示されます。そうでない場合は、提供する必要がある情報を引用するメッセージが表示されます。
[編集] をクリックすると、前の画面に戻って情報を更新できます。
アプリケーションを公開する準備ができたら、[Publish] をクリックします。
統計
Google Cast SDK Developer Console では、アプリケーションのパフォーマンスを追跡できます。[Applications] ページまたは [Overview] ページで公開済みの各アプリケーションについて、[Statistics] 列の [View] をクリックすると、パフォーマンス データを確認できます。
次の情報が表示されます。
- アプリを起動したキャスト レシーバーの数
- 起動されたセッションの数
- セッションあたりの平均メディア再生時間(分)
統計情報に [その他] プラットフォームが表示されている場合は、送信者がそのプラットフォームを指定していないことを意味します。たとえば、古い iOS 送信者が更新されていない場合などです。
デバイス
デフォルトでは、Google Cast デバイス(Chromecast や Android TV デバイスなど)は開発とテスト用に有効になっていません。開発中にデバイスを開発用デバイスに変え、公開前の Web Receiver アプリにアクセスするには、そのデバイスをアプリに登録する必要があります。登録すると、デバッグのためにリモート ブラウザ ウィンドウからレシーバーにアクセスできるようになります(デバッグをご覧ください)。
Google Cast デバイスを登録するには:
Google Cast デバイスをセットアップし、パソコンと同じ Wi-Fi ネットワークに接続します。
詳しくは、キャスト デバイスのセットアップの手順をご覧ください。
パソコンで Cast 対応のウェブブラウザを開きます。
Google Cast SDK Developer Console にログインします。
[Overview] ページまたは [Devices] ページで、[Add New Device] をクリックします。
デバイスのシリアル番号を入力します。
説明を入力して [OK] をクリックします。
これはデバイスのわかりやすい名前です(ユーザー設定時にデバイスに指定した名前と一致させる必要はありません)。
15 分待ってから次に進んでください。
登録が完了すると、デバイスのステータスに「テスト準備完了」と表示されます。
キャスト デバイスを再起動します。つまり、デバイスから電源ケーブルまたは USB ケーブルを取り外してから、接続し直します。
デバイスのシリアル番号を確認する
デバイスのシリアル番号を確認するには、Cast Developer Console のページをデバイスにキャストします。
キャスト ボタンをクリックします(このページをキャストする場合と同様にキャストします)。
プロンプトに [タブをキャスト] と、使用可能なデバイスが一覧表示されます。
プルダウン メニューから、シリアル番号を確認するデバイスを選択します。
- ディスプレイ デバイスの場合、シリアル番号がテレビ画面に表示され、テレビのスピーカーで読み上げられます(0 と O のあいまいにならないようにするため)。
- オーディオ機器の場合、シリアル番号はキャスト先のスピーカーで読み上げられます。
Android TV ソフトウェアのシリアル番号
Android TV(ATV)デバイスには、複数のシリアル番号が関連付けられています。ソフトウェア(キャスト)のシリアル番号は、前述のように Cast Developer Console ページを ATV デバイスにキャストするか、ATV デバイスをデベロッパー モードにしてキャストの設定でソフトウェアのシリアル番号を調べることで取得できます。
ATV デバイスをデベロッパー モードにするには、[設定] > [システム] > [デバイス情報] > [Android TV OS ビルド] に移動し、デベロッパー モードであることを示すメッセージがデバイスに表示されるまでビルドを数回クリックします。デベロッパー モードでシリアル番号を確認するには、ATV のモデルに応じて、[設定] > [デバイス設定] > [Chromecast built-in] または [設定] > [システム] > [キャスト] に移動すると、ソフトウェアのシリアル番号が表示されます。
ATV デバイスが出荷時の設定にリセットされると、ソフトウェアのシリアル番号が変更されます。出荷時の設定にリセットした後、上記の手順に沿ってソフトウェア シリアル番号を確認し、デバイスの新しいソフトウェア シリアル番号を Cast Console に再登録します。
アカウントに関する問題
Google Cast デベロッパー コンソールの登録をキャンセルしたい
5 ドルのデベロッパー アカウントの登録料は払い戻しできません。
Google Cast デベロッパー コンソールにアクセスできなくなった
利用規約またはコンテンツ ポリシーへの違反が複数回発生したためにデベロッパー アカウントが停止されているという内容のメールをすでに受け取っている場合、さらに詳しい説明が必要な場合は、そのメールにご返信ください。
Google Cast からアプリが削除された
削除されたアプリは、デベロッパー アカウントの状態が良好ではなくなります。度重なるポリシー違反や重大なポリシー違反があった場合、デベロッパー アカウントが停止される可能性があります。
削除されると、ユーザーは削除されたアプリケーションを表示したり、アクセスしたりできなくなります。Google Cast のデベロッパー認証情報がまだ良好な状態にあり、アプリの性質上、それが許容される場合は、問題を修正して、ポリシーに準拠した新しいアプリのインスタンスを公開できます。
ポリシー違反が修正されるまで、削除されたアプリを再公開しないでください。
アカウントに関連付けられているメールアドレスを変更したい
Google Cast デベロッパー アカウントに関連付けられているメールアドレスは変更できません。組織で勤務している場合は、今後アクセスの問題が発生しないように、チームのメールアドレスを使用することをおすすめします。
他にも問題がある
Cast SDK のサポートページをご覧ください。