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