ホーム画面でコンテンツをおすすめする

Android TV のホーム画面には、チャンネルと番組を使用しておすすめのコンテンツが表示されます。チャンネルはホーム画面に個別の行として表示され、そのチャンネルで視聴可能なすべての番組がカードに表示されます。

アプリには少なくとも 1 つのチャンネルが必要です。アプリが最初に作成したチャンネルはデフォルト チャンネルになり、Android TV はそのチャンネルを自動的にホーム画面に表示します。アプリは他のチャンネルを提供できますが、ホーム画面に追加する前に、ユーザーがチャンネルを選択して承認する必要があります。

アプリでテレビ番組、映画、その他の動画コンテンツを表示する場合は、動画プレビューをサポートし、「次のおすすめ」チャンネルと統合することをおすすめします。Watch Next チャンネルは、Android システムによって制御されます。アプリは、ユーザーが興味 / 関心としてマークした番組、視聴を途中でやめた番組、ユーザーが視聴しているコンテンツに関連する番組(シリーズの次のエピソードや次のシーズンなど)などのユーザー関連番組をこのチャンネルに追加できます。

互換性の確認

ホーム画面には、Android のバージョンに応じて 2 つの異なる方法でおすすめが表示されます。

  • Android 8.0(API レベル 26)以降では、アプリは別々の行に表示される 1 つ以上のチャンネルにおすすめを表示できます。1 つのチャンネル(デフォルト チャンネル)が常に表示されます。ユーザーは他のチャンネルを見つけてホーム画面に追加できます。ホーム画面におすすめチャンネルを作成する方法を学習する。
  • Android 8.0 より前では、Android TV はすべてのおすすめコンテンツを 1 つのおすすめ行に常に表示していました。ホーム画面に推奨事項の行を作成する方法をご覧ください。

すべてのバージョンの Android TV でおすすめを表示できるようにするには、アプリに両方のおすすめ API を実装する必要があります。現在のシステムの API レベルをテストし、適切な API を使用して推奨事項の行またはチャネルを作成します。

Kotlin

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

Java

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

API レベル 25 以前を使用してコンパイルされたアプリは、レベル 26 の Android TV でも実行できます。古い推奨事項の動作には上位互換性がありますが、制約があります。

  • おすすめの行は自動的に変換され、ホーム画面に新しいチャンネルとして表示されます。
  • 変換されたチャンネルの番組はおすすめサービスからの更新に応答しますが、ユーザーはテレビの UI を使用してチャンネルの番組を操作することはできません(番組の追加/削除、番組の Watch Next チャンネルへのコピー)。
  • アプリを API レベル 26 に更新しても、変換されたチャンネルは API 26 を搭載したテレビでは引き続き表示されます。新しい API で作成されたチャンネルをアプリが初めて表示するときに、変換されたチャンネルが画面から削除されます。この動作は、アプリがデフォルト チャンネルを作成した直後に、またはアプリによって作成された他のチャンネルをユーザーが選択して追加したときに、すぐに行われます。