Как добавить контент в канал "Смотреть дальше"

Канал "Смотреть дальше" – это вторая строка на главном экране, которая находится под строкой приложений. Этот канал создается и поддерживается системой. Ваше приложение может добавлять программы в канал "Смотреть дальше". Это могут быть программы, которые пользователь отметил как интересные, не досмотрел до конца или которые связаны с контентом, который он смотрит (например, следующая серия сериала или следующий сезон шоу).

Для канала "Смотреть дальше" действуют некоторые ограничения: ваше приложение не может перемещать, удалять или скрывать строку этого канала.

Шаги

Добавление программ в канал "Смотреть дальше" похоже на добавление программ в собственный канал. Подробная информация о разделе "Смотреть дальше" приведена ниже.

При вставке контента в канал "Смотреть дальше" необходимо следовать следующим рекомендациям:

Выберите тип программы

Существует четыре типа программ в разделе "Смотреть дальше". Выберите нужный тип:

Тип Примечания
WATCH_NEXT_TYPE_CONTINUE Пользователь остановил просмотр контента.
WATCH_NEXT_TYPE_NEXT Доступна следующая серия сериала, который смотрит пользователь. Например, если пользователь смотрит третью серию сериала, приложение может предложить ему посмотреть четвертую.
WATCH_NEXT_TYPE_NEW Теперь доступен новый контент, который явно соответствует тому, что смотрит пользователь. Например, пользователь смотрит пятую серию сериала, и в это время становится доступна шестая.
WATCH_NEXT_TYPE_WATCHLIST Вставляется системой или приложением, когда пользователь сохраняет программу.

Подробнее об атрибутах рекомендованных видео…

Как использовать WatchNextProgram builder

Используйте WatchNextProgram.Builder. Подробнее об атрибутах рекомендованных видео…

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()
    )

Используйте TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId), чтобы создать Uri, необходимый для обновления программы в разделе "Смотреть дальше".

Когда пользователь добавляет программу в канал "Смотреть дальше", система копирует ее в строку. Он отправляет намерение TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT, чтобы уведомить приложение о том, что программа добавлена. Намерение включает два дополнительных параметра: скопированный идентификатор программы и идентификатор программы, созданный для программы в канале "Смотреть дальше".