Fire TVのTV入力フレームワーク

リニアTVの統合は、TV入力サービスの開発に関するAndroidドキュメントに基づいています。Fire TV固有の技術要件を理解するには、以下のリンクや説明が役立ちます。

予備知識と用語
統合の詳細
認定チェックリスト
更新の実行
関連トピック

予備知識と用語

Fire TVのライブTV機能の詳細に立ち入る前に、予備知識と基本の理解が必要になります。統合を進める前に、以下のドキュメントを参照してください。

リニアTVの統合は、Androidドキュメントのテレビ入力サービスを開発するに基づいています。

統合の詳細

ライブリニアチャネルを統合するには、ユーザーのチャネル権限へのアクセスに加え、Fire TVでコンテンツが閲覧および検索されやすくするためのメタデータを提供する必要があります。

ライブチャネル権限

視聴権限のあるチャネルのみを（TV入力フレームワーク（TIF）によって提供されている）デバイスのローカルチャネルデータベースにプッシュするには、アプリを更新する必要があります。チャネルを更新（または追加／削除）するには、INITIALIZE_PROGRAMSアクションを使用してブロードキャストレシーバーを登録します。この視聴権限メタデータは、アプリが最初にインストールされたときに確実に更新されるようにします。これは、アプリがバックグラウンドで実行されている間でも実行できます。ブロードキャストレシーバーを登録してINITIALIZE_PROGRAMSアクションを処理する例については、BroadcastReceiverを登録してINITIALIZE_PROGRAMSアクションをリッスンする方法を参照してください。

チャネルの編集については、チャネルデータを利用するを参照してください。

このデータベースにチャネルがある場合、ユーザーはチャネルを視聴できます。チャネルの追加や削除はこのデータベースからいつでも行うことができ、変更は即座にUIに反映されます。これは、このデータベースが、ライブコンテンツの操作時に表示されるすべてのチャネルの情報源として使用されているためです。

TvContract.Channelsのチャネル列は、可能な限り埋めてください。GracenoteチャネルIDがわかっている場合や、再生のディープリンクを指定する場合は、Channels#COLUMN_INTERNAL_PROVIDER_DATAにその情報を含めることができます（コード例のセクションを参照してください）。

番組メタデータの取得

ライブTVのメタデータを提供するには、GracenoteチャネルIDを使用します。

ヒント： Gracenoteを使用するには、Gracenoteアカウントを持っている必要があります。

注：現時点では、地域に応じて、グローバルビデオデータ（GVD）とonTVの2つのGracenoteタイプがサポートされています（米国、英国、ドイツではOnTV、その他の地域ではGVD）。

Gracenote IDの指定

GracenoteチャネルID（onTVまたはGVD）を指定すると、ライブTVアプリを通じて情報が毎日クラウドと同期されます。Gracenote IDが見つかった場合は、最大14日間の番組情報を含むFire TVカタログ内でチャネルを検索する際に使用されます。この情報は、[ホーム] タブ、[ライブ] タブのほか、番組表にも表示されます。この情報は自動的に更新され、常に最新の状態に保たれます。また、検索機能やAlexaからも検出可能になります。

チャネルの順序

チャネルの順序によって、Fire TVデバイスのUIに表示されるチャネルのランクが決まります。基本の順序はプロバイダーが決定します。ユーザーはコンテキストメニューやチャネルマネージャーを使用して、チャネルをお気に入りとして設定できます。こうすると、そのチャネルが最も高い優先順位で表示されます。したがって、優先順位はお気に入り＞チャネルの順序オプションとなります。Fire TVでは、開発作業のレベルが異なる2つのオプションが用意されています。

表示名順は、開発時間を必要としない、従来の最も一般的な順序です。この順序を使用すると、Fire TV UIのチャネルは、displayNameに従ってUnicodeで表示されます。たとえば、チャネルリスト{“XYZ”, “1BC”, and “1 BK”}は、{“1 BK”, “1BC”, “XYZ”}という順序で表示されます。
もう1つのオプションは、カスタムのチャネル順です。この順序を使用すると、プロバイダーのチャネルは、tv.dbの「_id」と一致する順序で表示されます。この「_id」は、挿入された順に割り当てられます。tv.dbでこれらのチャネルを更新する場合は、チャネルの順序を維持する必要があります。これは、ライブTVアプリでもFire TV UIと同じ順序が使用されるためです。

一貫性のあるエクスペリエンスを提供するために、アプリ内での順序に最も近いチャネル順序を選択することを強くお勧めします。オンボーディングプロセスの一環として、Amazonの担当者と協力し、チャネル順序の決定方法を選択してください。

全画面再生

ディープリンク。Fire TVでは、独自のアプリで全画面再生を実行できる機能が提供されています。この機能を使用するには、ディープリンクインテントをチャネル情報の一部としてチャネルデータベースに挿入します。閲覧または検索中にチャネルが選択されると、このインテントが起動されます。インテントがアクティブになるたびに、リクエストされたチャネルの全画面再生が開始されます。詳細については、コードサンプルのセクションを参照してください。

スプラッシュ画面のガイドライン

ユーザーがタイルにフォーカスを置いた後、スプラッシュ画面が開始されるまでにかかる時間は、最大で3秒です。
フォーカスされたコンテンツのビデオプレビューの再生は、スプラッシュ画面が読み込まれてから2秒後に開始する必要があります。
パートナーがチャネルプレビューをサポートし（強く推奨）、ユーザーのFire TV設定で機能制限（PCON）が有効になっている場合、チャネルプレビューは無効になり（ミニ詳細での再生なし）、Gracenoteに既に含まれている画像の範囲に戻ります。Amazonは、Fire TVまたはパートナーアプリに設定されたコンテンツレーティングや環境設定をブロックしません。このルールはすべてのパートナーとチャネル提供元に適用されます。

アプリがチャネルプレビューをサポートし（強く推奨）、ユーザーによるFire TV設定でPCONが有効になっている場合、チャネルプレビューは無効になり（ミニ詳細での再生なし）、Gracenoteに既に含まれている画像の範囲に戻ります。Amazonは、Fire TVまたはパートナーアプリに設定されたコンテンツレーティングや環境設定をブロックしません。このルールはすべてのパートナーとチャネル提供元に適用されます。

機能制限

商品の要件に従って、機能制限（PCON）が有効になっている場合は、プレビュー再生でビデオを再生しないようにする必要があります。

TvInputServiceで指定されているサーフェスにアプリでコンテンツをレンダリングする場合（ライブプレビューの場合やチャネルのディープリンクがない場合）は、機能制限が適切に実装されている必要があります。機能制限が有効になっている場合、アプリはコンテンツを表示する前に、エンドユーザーにPINの入力を要求します。ブロックされるべきコンテンツが要求されるたびに、TvInputServiceでフォアグラウンドのアプリに通知する必要があります。推奨されるフローについては、コードサンプルのセクションを参照してください。

プロバイダーのアトリビューション

次の3つのアイテムを必ずカスタマイズしてください。

1.ラベル

デフォルトでは、アプリのlabelは、ユーザーがチャネルを閲覧する際にヘッダーとして使用されます。このラベルは、12文字以下の全角文字または24文字以下の英数字にする必要があります。別の名前を使用したくてもlabelを変更できない場合は、Amazon担当者と相談してオーバーライドされるようにしてください。

2.ロゴ

アプリのブランドを表すモノクロロゴ（白い画像、透明な背景）を1つ指定してください。ロゴは番組アートの上にオーバーレイされます。この画像ファイルの高さは最大34px、幅は最大でオーバーレイ画像の幅の25%までとする必要があります。

詳細については、Amazonの担当者にお問い合わせください。

パッケージマネージャーでアプリバナーを指定します。例については、コードサンプルのセクションを参照してください。

認定チェックリスト

Amazonは、以下のチェックリストを使用して、ライブTVが統合されたアプリを認定します。アプリの実装が直接関係する動作ポイントは次のとおりです。また、認定の例外は、状況に応じた対応となります。

権限状態の変更

ユーザーが次のいずれかを実行すると、視聴権限のあるチャネルがFire TVのUIに表示されます（[放映中のチャンネル] 行、チャネルガイドなど）。（1）アプリを開いてサインインする。（2）[設定] > [ライブTV] > [チャンネル提供元を同期] > ＜アプリ名＞からアプリの設定ページにアクセスする。開発者はこれら両方の条件を確認する必要があります。
ユーザーのメンバーシップ期限が切れた場合（つまり、「視聴権限がなくなった」場合）、ユーザーがチャネルにアクセスしてペイウォールに到達し、オファーをキャンセルまたは拒否するまで、チャネルはFire TVのUIに表示され続けます。
チャネルは、アプリがアンインストールされたとき、またはチャネルの視聴権限が無効になったときに、Fire TVのUIから削除されます。

最大ロールアウトレート

ユーザーに対するチャネルの段階的ロールアウトは、1時間あたり最大50万のレートで実行されます。

この値は、チャネルの視聴権限があるユーザーのFire TVデバイスの数を示します。チャネルの視聴権限がある状態とは、Fire TV内のリニアTV統合のUXからワンクリックで全画面再生を行うことができる状態を指します。

例：

ABCアプリはビデオオンデマンドを提供していますが、プレミアムアドオンとしてライブTV機能も備えています。この場合、ライブTVのアドオンを利用しているABCユーザーのみがロールアウトの対象となります。
XYZアプリには、無料の基本チャネルパッケージに加えて、さらに多くのチャネルを視聴できる有料プランが用意されています。この有料プランのチャネル編成が更新された場合、ロールアウトの対象となるのはその有料プランのユーザーのみです。

閲覧と再生

ユーザーがチャネルにフォーカスすると、詳細なメタデータが提供されます。リニアTVガイドに表示されるチャネルには、チャネルのロゴ、チャネル番号（オプション）、今後14日間のスケジュール情報が含まれます。番組のメタデータには、番組名、再生時間、エピソード名、エピソードの詳細な説明、シーズンとエピソードの情報、クローズドキャプション、レーティング、番組画像（16：9）、背景画像（16：9）が含まれます。このメタデータ情報は、Gracenoteのマッチング、またはTVコントラクトの一部としてプッシュされるメタデータから提供されます。
ユーザーが [放映中のチャンネル] 行のチャネルにフォーカスすると、背景画像に代わってライブチャネルのプレビューが表示されます。
ユーザーは、視聴権限のあるこのチャネルの提供元を把握できる必要があります。このため、背景画像（モノクロ、高さ34px）の一部として、またはライブチャネルプレビューの再生前のスプラッシュ画面として、プロバイダーアトリビューションを追加します。
ユーザーがチャネルを選択すると、全画面再生が開始されます。[戻る] ボタンを1～2回押すとFire TVのUIに戻ります。
機能制限（PCON）が有効になっている場合、再生前にPINの入力を求めるプロンプトが表示されます。PCONが有効になっている場合は、ライブチャネルプレビューを無効にする必要があります。
Alexaにアクセスする場合は、再生するライブコンテンツの音量を下げます（ビデオは続行されます）。
（任意）ジャンルをチャネルに割り当てることができます。この場合、Fire TV UIの追加入力ポイントでチャネルが表示されます。

開発、ステージング、デプロイ

本番環境に進む前に、Amazonが特定のアカウントを許可リストに登録して、統合されたエクスペリエンスを確認および認定できる必要があります。
視聴権限のあるチャネルのみが、両者がリリースに同意したマーケットプレイスのFire TV UIに追加されます。その後、別のマーケットプレイスでリリースする際には、新しい認定レビューとして扱われ、許可リストへの登録が必要となります。
リリース後に追加または削除されるチャネルはすべて、Amazonが把握する必要があります。追加されるチャネルの上限については、両者の合意が必要です。
（強く推奨）アプリのダウンロードページとリリースノートには、ユーザーがFire TVで利用可能な新機能を把握できるように、ライブTVの統合について記載してください。

更新の実行

アプリを更新する場合は、更新を実行する前に、認定チェックリストの項目を再度確認してください。

チャネル編成を更新する場合は、認定チェックリストの項目を再度確認し、さらに以下も実行してください。

公開の2週間以上前に、Fire TVの担当者に公開タイムラインを通知してください。
編成内容に10%以上の増減がある場合は、Fire TVの担当者から明示的な承認を受けてください。

Last updated: 2025年3月5日