アプリ デベロッパーは、Watch Next チャンネルにコンテンツを挿入する際に次のガイドラインを遵守する必要があります。
Watch Next チャンネルに含めるコンテンツの種類
アプリのプログラムによる追加を、従来の映画とテレビ番組に制限する必要があります。クリップやその他の短い形式のコンテンツを追加しないでください。
未視聴の映画
未視聴の映画(以下で定義)を Watch Next チャンネルに追加するには、TYPE_MOVIE
を使用します。
- 3% または 2 分(タイムスタンプが前のほう)を超えて視聴した場合、ユーザーは映画を「視聴開始」したことになります。
- エンド クレジットが始まった場合、ユーザーは映画を「視聴完了」したことになります。この場合は、Watch Next チャンネルにその映画を追加しないでください。この状態を判断するには、エンド クレジットを自動検出する技術や、コンテンツの長さに基づく概算を使用します。
未視聴の番組エピソード
未視聴のエピソード(以下で定義)を Watch Next チャンネルに追加するには、TYPE_TV_EPISODE
を使用します。
- 3 分を超えて視聴した場合、ユーザーはエピソードを「視聴開始」したことになります。
- エンド クレジットが始まった場合、ユーザーはエピソードを「視聴完了」したことになります。この場合は、Watch Next チャンネルにその番組を追加しないでください。この状態を判断するには、エンド クレジットを自動検出する技術や、コンテンツの長さ(エピソードの残りが 3 分未満など)に基づく概算を使用します。
新しい番組エピソードと次の番組エピソードの処理
新しいエピソードと次のエピソード(以下で定義)を Watch Next チャンネルに追加するには、TYPE_TV_EPISODE
を使用します。
- シリーズのいずれかのエピソードを 3 分(またはイントロダクションの終了後 1 分)を超えて視聴した場合、ユーザーはそのシリーズを「視聴開始」したことになります。
- ユーザーがシリーズを「視聴開始」して 1 つのエピソードを「視聴完了」し、シリーズの次のエピソードがサービス内で視聴可能な場合、
WATCH_NEXT_TYPE_NEXT
を使用して、この次のエピソードを Watch Next チャンネルに追加します。 - ユーザーがシリーズを「視聴開始」し、未視聴のエピソードがなくなり(つまり、最新エピソードを含むすべての視聴可能なエピソードを視聴し)、新しいシーズンまたはエピソードが後日視聴可能になる場合、
WATCH_NEXT_TYPE_NEW
を使用して、その新しいエピソードを Wacht Next チャンネルに追加します。新しいエピソードが視聴可能になるのがどれほど先であっても(たとえば 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 に公開する必要があります。
新しいエピソード
次のすべてに当てはまる場合は、すぐに WATCH_NEXT_TYPE_NEW
アイテムを追加します。
- 新しいエピソードがサービスで視聴可能である。
- ユーザーが前のエピソードを視聴し終わった。
- ユーザーは新しいエピソードを視聴する権利がある。
新しいエピソードが視聴可能になるのがどれほど先であっても(たとえば 1 年後かそれ以上)、このエピソードを追加します。
コンテンツと UI の更新の対象
コンテンツが Watch Next チャンネルに公開される対象となるには、ユーザーがアプリ内のそのコンテンツを過去に操作していた必要があります。
同じテレビシリーズの複数のエピソードを追加しないでください。たとえば、同じテレビ番組の未視聴のエピソードと新しいエピソードを追加しないでください。
[次のおすすめ] 行のいずれか 1 つのアイテムに変更がある場合でも、すべてのアイテムを更新しないでください。 前回の更新以降にユーザーが操作したアイテムのみを更新してください。
Watch Next アイテムに含めるデータ
Watch Next の各アイテムには次の情報を含める必要があります。
- Watch Next のタイプ
- 前回の再生位置
- 再生時間
- 前回のエンゲージメント時間
- 動画プログラムの属性: 動画プログラムの属性の表で示した必須の属性に加えて、Content ID の属性をすべての動画プログラムに設定する必要があります。Content ID の属性は、メディア アクション フィードで指定している内部 ID と一致する必要があります。そうすることで、Android TV はアセットをより効果的に調整し、ユーザーに信頼性の高い機能を提供できます。