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