スタイル付きメディア レシーバーを使用している場合、またはカスタム レシーバーを作成する場合は、アプリケーションを登録する必要があります。アプリケーションを登録すると、アプリケーション ID が送信されます。この ID は、送信側アプリケーションが API 呼び出し(Web Receiver アプリケーションを起動するなど)を行うために使用します。
デフォルトのメディア レシーバーを使用する場合は、アプリを登録する必要はありません。デフォルト メディア レシーバでは、メディア プレーヤーの UI にスタイル設定を行うことはできません。指定した定数はアプリケーション ID として使用されます。
また、公開する前に Web Receiver アプリケーションにアクセスできるように、Google Cast デバイスを登録する必要があります。レシーバー アプリケーションを公開すると、すべての Google Cast デバイスで使用できるようになります。
アプリケーション
アプリを登録すると、アプリを公開する前に登録済みのキャスト デバイスでテストできます。アプリを公開すると、すべてのキャスト デバイスで利用できるようになります。
アプリケーションを登録する
送信側アプリケーションから API 呼び出しで使用されるアプリケーション ID を受信するには、スタイル付きメディア レシーバーまたはカスタム レシーバーを登録する必要があります。
Cast アプリケーションを登録するには:
- Google Cast SDK Developer Console にログインします。
- [概要] ページまたは [アプリケーション] ページで [新しいアプリケーションを追加] をクリックします。
使用する Web Receiver アプリの種類を選択します。
カスタム レシーバー
スタイル付きメディア レシーバーが提供しないユーザー インターフェース コンポーネントや操作パターンがアプリに必要な場合は、このオプションを選択します。コンテンツ タイプが Styled Media Receiver のサポートされているメディアタイプに含まれていない場合は、カスタム レシーバも選択する必要があります。
このオプションでは、Web Receiver アプリ用の完全なウェブアプリを構築する必要があります。
詳細については、カスタム レシーバ アプリケーションをご覧ください。
スタイル付きメディア レシーバー
アプリがサポートされているメディアタイプを使用して動画またはオーディオ コンテンツをストリーミングし、デフォルトのメディア プレーヤーの UI またはデフォルトのメディア プレーヤーの UI に加えてカスタム スタイルのセットを使用する、ユーザー インターフェースをテレビに提供する場合は、このオプションを選択します。
カスタム スタイルを指定すると、CSS ファイルを提供するだけで、プレーヤーの UI のさまざまな要素(スプラッシュ画面や進行状況バーなど)の外観を定義できます。レシーバー アプリを作成する必要はありません。
詳しくは、スタイル付きメディア レシーバーをご覧ください。
Web Receiver アプリの詳細を入力します。
[Name] フィールドにアプリ名を入力します。
これは、ウェブ レシーバーの読み込み時や、スタイル付きメディア レシーバーを使用している場合はアイドル状態のときに表示されるアプリケーション名です。カスタム レシーバを使用している場合は、
setApplicationState
メソッドを使用して設定されていない場合、このフィールドの値はアプリケーション状態のデフォルト値になります。Web Receiver アプリの外観を指定します。
[Custom Receiver] の [URL] にアプリ URL を指定します。
Web Receiver アプリを読み込むときに Google Cast デバイスがリクエストする URL を入力します。開発中は URL で HTTP を使用できますが、アプリを公開するときは HTTPS を使用する必要があります。URL は、ウェブブラウザからアクセス可能な HTML ページやその他のファイル形式です。ウェブ レシーバがトップレベル ドメインであることはほとんどないため、ローカル(NAT で登録済み)の IP アドレスでも localhost ではなくても構いません。Web Receiver アプリは、公開時に SSL(HTTPS)を介して提供する必要がありますが、Web Receiver アプリに読み込まれたコンテンツは HTTP 経由で配信される可能性があります。
[Styled Media Receiver] の [Skin URL] フィールドに、スタイルシートの URL を指定します。
専用のウェブサイトにある CSS ファイルを参照する HTTPS URL を指定します。デフォルトのスタイルを使用する場合は、この項目を空にします。カスタム スタイルを提供または更新する場合は、後でいつでも編集できます。
[Google Cast ゲストモードのサポート] チェックボックスをオンまたはオフにします。
ゲストモードを使用すると、レシーバーが、同じ Wi-Fi ネットワークに接続されていない送信者からのキャストをサポートできるようになります。レシーバのゲストモードを無効にするには、このチェックボックスをオフにします。詳しくは、GuestMode をご覧ください。
[音声のみのデバイスへのキャストに対応している] チェックボックスをオンまたはオフにします。
アプリがオーディオ デバイス用の Google Cast を検出できるようにするには、このチェックボックスをオンにします。音声のみのデバイスのサポートを無効にするには、このチェックボックスをオフにします。詳しくは、オーディオ機器をご覧ください。
[保存] をクリックします。
アプリケーション ID、名前、種類、ステータスなどの登録の詳細が表示されます。アプリケーション ID をメモしておきます。この ID は、アプリケーションの Cast API 呼び出しで使用します。
[完了] をクリックして [アプリケーション] ページに戻ります。
アプリケーション情報の編集
アプリを公開する前に、いくつかの追加情報を提供する必要があります。登録時に提供したアプリに関する情報を更新することもできます。
アプリケーション情報を編集するには:
- Google Cast SDK Developer Console の [概要] ページまたは [アプリケーション] ページで [アプリケーション ID] をクリックするか、編集するアプリの [編集] をクリックします。
- [Name] フィールドで、アプリケーションの登録時に指定した名前を更新します。
- カスタム レシーバ アプリケーションの [URL] フィールドで、登録した Web Receiver アプリケーションの場所を更新します。
- スタイル付きレシーバーのアプリの場合、[スキンの URL] フィールドで、アプリケーションのスタイルシートの場所を更新します。
[Google Cast ゲストモードのサポート] チェックボックスをオフまたはオフのままにします。
ゲストモードを使用すると、レシーバーと同じ Wi-Fi ネットワークに接続されていない送信者からのキャストを、ウェブレシーバーがサポートできるようになります。レシーバーのゲストモードを無効にするには、このチェックボックスをオフにします。詳しくは、ゲストモードをご覧ください。
[音声のみのデバイスへのキャストに対応している] チェックボックスをオフまたはオフのままにします。
アプリがオーディオ デバイス用の Google Cast を検出できるようにするには、このチェックボックスをオンにします。 音声のみのデバイスのサポートを無効にするには、このチェックボックスをオフにします。詳細については、オーディオ デバイスをご覧ください。
[送信者の詳細] で、アプリがサポートするプラットフォームごとに次の情報を入力します。
Android:
- アプリケーション パッケージの完全修飾名。
iOS:
- Apple が必要とする iTunes ID とバンドル ID。
- アプリの起動 URI。Google Home アプリがアプリを起動する際に使用する URI です。必要な URI 形式について詳しくは、URL スキームを使用してアプリと通信するをご覧ください。
ウェブ:
- アプリケーションのウェブサイトの URL です。
[掲載情報の詳細] で、Google プロパティ(chromecast.com/apps など)にアプリを表示するかどうかを選択します。
[Category] プルダウン メニューから、アプリケーションに最も当てはまるカテゴリを選択します。
注: アプリは、ここで説明するメディアタイプだけでなく、他の設定で暗黙的に指定されているメディアタイプもサポートしている必要があります。たとえば、アプリで音声用 Google Cast がサポートされていて、ここでテレビと映画を選択した場合、アプリはオーディオ デバイスで説明されている音声のみのデバイスだけでなく、動画再生のプロビジョニングもサポートする必要があります。
アプリを利用できる国を指定するには、[すべての国] または [選択した国のみ] のいずれかのラジオボタンを選択します。国を指定する場合は、表示されるリストで該当する国のチェックボックスをオンにします。
[Title] フィールドに、アプリケーションのわかりやすいタイトルを入力します。
半角 50 文字以内で入力してください。例: 「YouTube」
[説明] フィールドに、アプリケーションの説明を入力します。
半角 80 文字(全角 40 文字)以内で入力してください。「お気に入りの YouTube チャンネルを自宅の最高の画面で楽しめます。」
[Graphics] セクションで、プラス記号をクリックして、アプリケーションのアイコン画像をアップロードします。
画像は 512 x 512 ピクセルの画像で、背景が透明である必要があります。
[独自の翻訳を追加] で [タイトル] フィールドと [説明] フィールドに翻訳を提供するには、プルダウン メニューから言語を選択して [追加] をクリックし、表示されるダイアログで翻訳されたテキストを入力します。また、その翻訳に固有のアイコンの画像をアップロードすることもできます。
アプリケーション情報の更新が完了したら、[保存] をクリックします。
アプリケーションを発行
アプリを公開すると、世界中のすべてのキャスト デバイスでアプリを利用できるようになります。また、chromecast.com/apps のリストサイトなどの Google サービスでアプリの掲載情報が作成されます。ユーザーはこのサイトでアプリを見つけてダウンロードできます。上記のステップ 6 でアプリの情報を編集したときにアプリの掲載情報を選択した場合は、Chromecast.com/apps に公開後のアプリが表示されます。
アプリケーションを公開するには:
Google Cast SDK Developer Console の [概要] ページまたは [アプリケーション] ページで、公開するアプリの [公開] をクリックします。
アプリケーション情報が完成すると、アプリケーション情報の編集で入力したアプリケーション情報のプレビュー画面が表示されます。その場合は、提供する必要がある情報を示すメッセージが表示されます。
[編集] をクリックして戻り、情報を更新できます。
アプリケーションを公開する準備が整ったら、[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 にログインします。
- ATV デバイスのシリアル番号の確認方法については、シリアル番号の確認をご覧ください。
概要ページまたはデバイスページで [新しいデバイスを追加] をクリックします。
デバイスのシリアル番号を入力します。
説明を入力して [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 Developer Console に再登録します。
アカウントに関する問題
Google Cast Developer Console の登録をキャンセルしたい
この 5 ドルのデベロッパー アカウント登録料は払い戻しできません。
Google Cast デベロッパー コンソールにアクセスできなくなった
Google の利用規約またはコンテンツ ポリシーへの違反の繰り返しによりデベロッパー アカウントが一時停止されている旨の通知を以前に Google から受け取った場合、さらに詳しい説明が必要な場合は、このメールにご返信ください。
アプリが Google Cast から削除されました
削除されたアプリは、デベロッパー アカウントの状態が良好ではなくなります。ポリシー違反を繰り返したり、重大なポリシー違反を犯したりすると、デベロッパー アカウントが停止される場合もあります。
削除されると、ユーザーは削除されたアプリケーションを表示、アクセスできなくなります。Google Cast でデベロッパーの認証情報がまだ良好な状態であり、アプリの性質上、デベロッパーの認証情報が許される場合は、その修正を行い、ポリシーを遵守した新しいバージョンのアプリを公開できます。
ポリシー違反が解決されるまで、削除されたアプリを再公開しないでください。
アカウントに関連付けられたメールアドレスを変更したい
Google Cast デベロッパー アカウントに関連付けられているメールアドレスは変更できません。組織に所属している場合は、今後アクセス上の問題が発生しないように、チームのメールアドレスを使用することをおすすめします。
他にも問題がある
Cast SDK のサポートページをご覧ください。