Watch Next チャンネルにコンテンツを挿入する場合は、以下のガイドラインを遵守する必要があります。
Watch Next チャンネルに含めるコンテンツの種類
アプリのプログラムによる追加を、従来の映画とテレビ番組に制限する必要があります。 クリップやその他の短い形式のコンテンツを追加しないでください。
未視聴の映画を含める
未視聴の映画を Watch Next チャンネルに追加するには、TYPE_MOVIE を使用します。映画が視聴途中の状態かどうかは、以下のガイドラインに基づいて判断します。
- 3% または 2 分（タイムスタンプが前のほう）を超えて視聴した場合、ユーザーは映画を視聴開始したことになります。
- エンド クレジットが始まった場合、ユーザーは映画を視聴完了したことになります。この場合は、Watch Next チャンネルにその映画を追加しないでください。 この状態を判断するには、エンド クレジットを自動検出する技術や、コンテンツの長さに基づく概算を使用します。
未視聴の番組エピソードを含める
未視聴の番組エピソードを Watch Next チャンネルに追加するには、
TYPE_TV_EPISODE を使用します。エピソードが視聴途中の状態かどうかは、以下のガイドラインに基づいて判断します。
- 2 分を超えて視聴した場合、ユーザーはエピソードを視聴開始したことになります。
- エンド クレジットが始まった場合、ユーザーはエピソードを視聴完了したことになります。この場合は、Watch Next チャンネルにそのエピソードを追加しないでください 。この状態を判断するには、エンド クレジットを自動検出する技術や、コンテンツの長さ（エピソードの残りが 3 分未満など）に基づく概算を使用します。
新しい番組エピソードと次の番組エピソードの処理
ユーザーが視聴を開始したシリーズの新しいエピソードと次のエピソードを Watch Next チャンネルに追加するには、
以下のガイドラインに基づいて
TYPE_TV_EPISODEを使用します。
- シリーズのいずれかのエピソードを 2 分（またはイントロダクションの終了後 1 分）を超えて視聴した場合、ユーザーはそのシリーズを視聴開始したことになります。
- ユーザーがシリーズを視聴開始して 1 つのエピソードを視聴完了し、シリーズの次のエピソードが
サービス内で視聴可能な場合、この次のエピソードを Watch
Next チャンネルに追加します。
WATCH_NEXT_TYPE_NEXT - ユーザーがシリーズの現在のすべてのエピソードを視聴し終え、新しい
シーズンまたはエピソードが視聴可能になった場合、その新しいエピソードを Watch Next
チャンネルに
WATCH_NEXT_TYPE_NEWを使用して追加します。新しいエピソードが視聴可能になるのがどれほど先であっても（たとえば 1 年後かそれ以上）、そのエピソードを追加します。
Watch Next チャンネルにアイテムを追加するタイミング
未完了のコンテンツと過去に視聴したシリーズの新しいエピソードを Watch Next チャンネルに追加する際は、次のガイドラインを遵守してください。
未完了のコンテンツを追加するタイミング
ユーザーが未完了のコンテンツを視聴している場合、次のいずれかの状態が発生したらすぐに、そのコンテンツを Watch Next チャンネルに追加します。
- ユーザーが Android TV でアプリを終了した。
- ユーザーがコンテンツの再生を一時停止または停止している時間が 5 分を超えた。
上記の状態になったすべての未視聴のコンテンツをすぐに（最大レイテンシ 5 秒）公開します。たとえば、ユーザーが Android TV アプリを終了したら、5 秒以内に Watch Next API を使用してすべての未完了のアイテムを公開します。
視聴場所に関係なく、未完了のコンテンツを 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 チャンネルからコンテンツを削除する
ユーザーが映画の視聴を完了した場合、またはテレビシリーズの未視聴の視聴可能なエピソードがなくなった場合は、コンテンツを削除します。