プログラムを Watch Next チャンネルに追加する

Watch Next チャンネルは、ホーム画面のアプリの次の行(2 行目)です。このチャンネルはシステムが作成し管理します。アプリでは、ユーザーによって興味があるとマークされたプログラム、視聴途中のプログラム、視聴中のプログラムに関連するプログラム(次のエピソードやシーズンなど)などを、Watch Next チャンネルに追加できます。

Watch Next チャンネルにはいくつかの制限があります。アプリは Watch Next チャンネルの行の移動すること、削除すること、非表示にすることができません。

手順

Watch Next チャンネルへのプログラムの挿入方法は、独自のチャンネルにプログラムを挿入する場合と同様です。 Watch Next に固有の詳細情報については、以下のセクションをご覧ください。

Watch Next チャンネルにコンテンツを挿入する場合は、以下のガイドラインを遵守する必要があります。

プログラムのタイプを選択する

Watch Next プログラムには 4 つのタイプがあります。適切なタイプを選択してください。

タイプ備考
WATCH_NEXT_TYPE_CONTINUEユーザーがコンテンツの視聴を止めたもの。
WATCH_NEXT_TYPE_NEXTユーザーが視聴中のシリーズのうち、視聴可能な次のプログラム。たとえば、シリーズのエピソード 3 を視聴している場合、その次としてエピソード 4 をおすすめできます。
WATCH_NEXT_TYPE_NEWユーザーが視聴しているコンテンツの続きで、新しく視聴可能になったコンテンツ。たとえば、ユーザーがシリーズのエピソード 5 を視聴していて、エピソード 6 が視聴可能になった場合。
WATCH_NEXT_TYPE_WATCHLISTユーザーがプログラムを保存するときに、システムまたはアプリによって挿入されたもの。

詳細については、Watch Next 属性をご覧ください。

WatchNextProgram ビルダーを使用する

WatchNextProgram.Builder を使用します。詳細については、Watch Next 属性をご覧ください。

Kotlin

    val builder = WatchNextProgram.Builder()
    builder.setType(TvContractCompat.WatchNextPrograms.TYPE_CLIP)
            .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
            .setLastEngagementTimeUtcMillis(time)
            .setTitle("Title")
            .setDescription("Program description")
            .setPosterArtUri(uri)
            .setIntentUri(uri)
            .setInternalProviderId(appProgramId)

    val watchNextProgramUri = context.contentResolver
            .insert(TvContractCompat.WatchNextPrograms.CONTENT_URI,
                    builder.build().toContentValues())
    

Java

    WatchNextProgram.Builder builder = new WatchNextProgram.Builder();
    builder.setType(TvContractCompat.WatchNextPrograms.TYPE_CLIP)
            .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
            .setLastEngagementTimeUtcMillis(time)
            .setTitle("Title")
            .setDescription("Program description")
            .setPosterArtUri(uri)
            .setIntentUri(uri)
            .setInternalProviderId(appProgramId);

    Uri watchNextProgramUri = context.getContentResolver()
            .insert(TvContractCompat.WatchNextPrograms.CONTENT_URI, builder.build().toContentValues());
    

TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId) を使用して、Watch Next プログラムの更新に必要な Uri を作成します。

ユーザーがプログラムを Watch Next チャンネルに追加すると、システムはプログラムを行にコピーします。インテント TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT を送信して、プログラムが追加されたことをアプリに通知します。このインテントには、コピーされたプログラム ID と、Watch Next チャンネル内のプログラムのために作成されたプログラム ID の 2 つの補足情報が含まれます。