將節目新增至「接下來請觀看」頻道

「接下來請看」頻道是主畫面上的第二列,位於應用程式列之後。系統建立並維護這個頻道。您的應用程式可在「接下來請看」頻道中新增節目:使用者標示為感興趣的節目、途中停止觀看的節目,或是與使用者觀看內容相關的節目 (例如系列的下一集或節目的下一季)。

「接下來請看」頻道有幾項限制:應用程式無法移動、移除或隱藏「接下來請看」頻道的列。

步驟

將節目插入「接下來請看」頻道,與將節目插入自有頻道類似。如要瞭解「接著看」的詳細資訊,請參閱下列章節。

將內容插入「接下來請觀看」頻道時,請務必遵守下列指南:

選取計畫類型

「接著看」節目分為四種類型。選取適當的類型:

類型 附註
WATCH_NEXT_TYPE_CONTINUE 使用者在觀看內容時停止。
WATCH_NEXT_TYPE_NEXT 使用者正在觀看的影集有下一集。舉例來說,如果使用者正在觀看影集的第 3 集,應用程式可以建議他們接著觀看第 4 集。
WATCH_NEXT_TYPE_NEW 現在,系統會根據使用者的觀看內容,提供明確相關的新內容。舉例來說,使用者正在觀看某個系列的第 5 集,而第 6 集已可觀看。
WATCH_NEXT_TYPE_WATCHLIST 使用者儲存節目時,系統或應用程式會插入這項資訊。

詳情請參閱「『稍後觀看』屬性」。

使用 WatchNextProgram 建構工具

使用 WatchNextProgram.Builder。詳情請參閱「『稍後觀看』屬性」。

Kotlin

val builder = WatchNextProgram.Builder()
builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE)
        .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_MOVIE)
        .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) 建立更新「接下來請看」節目的 Uri。

使用者將節目新增至「接下來請看」頻道時,系統會將節目複製到該列。並傳送意圖 TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT 通知應用程式已新增節目。這項意圖包含兩項額外資訊:複製的節目 ID,以及為「接下來請看」頻道中的節目建立的節目 ID。