Watch Next チャンネルにコンテンツを挿入する場合は、以下のガイドラインに従ってください。
Watch Next チャンネルに含めるコンテンツの種類
アプリのプログラマティックな追加は、従来の映画やテレビ番組に限定してください。クリップやその他の短い形式のコンテンツは追加しないでください。
視聴途中の映画を含める
視聴途中の映画を Watch Next チャンネルに追加するには、TYPE_MOVIE を使用します。開始されているものの、次のガイドラインに基づいて終了していない場合、その映画は未視聴となります。
- ユーザーが 3% を超えるか 2 分を超えるかのいずれか早い方で視聴すると、映画が開始されます。
- 終了クレジットが開始されると、映画は終了します。この場合、Watch Next チャンネルに追加しないでください。この状態は、エンド クレジットを自動検出する技術か、コンテンツの長さに基づく近似値を使用して判断できます。
途中まで再生したテレビ番組のエピソードを含める
TYPE_TV_EPISODE を使用して、視聴途中の番組エピソードを Watch Next チャンネルに追加します。開始されているものの、以下のガイドラインに基づいて終了していない場合、そのエピソードは未視聴となります。
- ユーザーが 2 分以上視聴した場合、エピソードが開始します。
- エンド クレジットを開始すると、そのエピソードは終了します。この場合、Watch Next チャンネルに追加しないでください。この状態は、エンド クレジットを自動検出する技術や、コンテンツの長さに基づく近似値（エピソードの残り時間が 3 分未満など）を使用して判断できます。
新しいテレビ番組エピソードと次のテレビ番組エピソードを処理する
次のガイドラインに基づいて、ユーザーが開始したシリーズの新しいエピソードと次のエピソードを、TYPE_TV_EPISODE を使用して Watch Next チャンネルに追加します。
- ユーザーは、シリーズのいずれかのエピソードを 2 分以上視聴した場合、または導入が完了してから 1 分以上視聴した場合、シリーズを開始できます。
- ユーザーがシリーズを開始してエピソードを最後まで再生し、シリーズの次のエピソードがサービスで提供されている場合は、
WATCH_NEXT_TYPE_NEXTを使用してこの次のエピソードを Watch Next チャンネルに追加します。 - ユーザーがシリーズの最新エピソードをすべて把握していて、新しいシーズンやエピソードが利用できるようになった場合は、
WATCH_NEXT_TYPE_NEWを使用してこの新しいエピソードを Watch Next チャンネルに追加します。ユーザーがシリーズを最後に視聴してからの経過期間（1 年以上後など）に関係なく、新しいエピソードを追加します。
アイテムを Watch Next チャンネルに追加するタイミング
以下のガイドラインに沿って、視聴途中のシリーズの視聴途中のコンテンツと新しいエピソードを Watch Next チャンネルに追加します。
視聴途中のコンテンツを追加するタイミング
ユーザーに未視聴のコンテンツがある場合、次のいずれかが発生したらすぐにそのコンテンツを Watch Next チャンネルに追加します。
- ユーザーが Android TV でアプリを終了した。
- ユーザーがコンテンツの再生を 5 分以上一時停止または停止した。
このようなシナリオでは、未視聴のコンテンツをすぐに公開します。最大レイテンシは 5 秒です。たとえば、ユーザーが Android TV アプリを終了した場合、Watch Next API を使用して未視聴のアイテムを 5 秒以内に公開します。
視聴が行われた場所に関係なく、視聴途中のコンテンツを Watch Next API を使用して Android TV にパブリッシュします。たとえば、ユーザーが Chrome ブラウザで映画を視聴中に一時停止した場合、Android TV のアプリは、視聴途中のコンテンツを最長 5 秒のレイテンシで直ちに Android TV に公開する必要があります。
新しいエピソードを追加するタイミング
以下の条件をすべて満たしている場合、以前に視聴したシリーズの新しいエピソードをすぐに追加します。
- 新しいエピソードがサービスで視聴可能である。
- ユーザーが前のエピソードを視聴し終わった。
- ユーザーは新しいエピソードを視聴する権利がある。
ユーザーがシリーズを最後に視聴してからの経過期間（1 年以上後など）に関係なく、新しいエピソードを追加します。
コンテンツと UI の更新の対象
コンテンツが Watch Next チャンネルに公開されるようにするには、ユーザーがアプリ内でコンテンツを操作する必要があります。
同じテレビシリーズの複数のエピソードを追加しないでください。たとえば、視聴途中のエピソードと、同じシリーズの新しいエピソードを追加しないでください。
1 つのアイテムが変更されたときに「次のおすすめ」行内のすべてのアイテムを更新しないようにする。 前回の更新以降にユーザーが操作したアイテムのみを更新します。
Watch Next アイテムに含めるデータ
Watch Next の各アイテムには、以下の情報を含めます。
- Watch Next のタイプ
- 前回の再生位置
- 所要時間
- 前回のエンゲージメント時間
- 動画プログラムの属性: 動画プログラムの属性の表に記載されている必須属性に加えて、すべての動画プログラムに Content ID 属性を設定する必要があります。Content ID 属性は、メディア アクション フィードで指定する内部 ID と一致する必要があります。これにより、Android TV はアセットをより効果的に調整でき、ユーザーに信頼性の高い機能を提供できます。
Watch Next チャンネルからコンテンツを削除する
ユーザーが映画の視聴を終了した後、またはテレビシリーズの未視聴のエピソードがなくなったら、コンテンツを削除します。