Рекомендовать контент на главном экране

На главном экране Android TV показывается рекомендованный контент из каналов и программ. Каналы отображаются в виде отдельных строк на главном экране с карточками, на которых показаны все доступные программы для этого канала.

В приложении должен быть хотя бы один канал. Первый канал, созданный вашим приложением, становится каналом по умолчанию, и Android TV автоматически показывает его на главном экране. Приложение может предлагать и другие каналы, но пользователь должен выбрать и одобрить их, прежде чем они будут добавлены на главный экран.

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

Проверьте совместимость

Рекомендации на главном экране могут показываться двумя способами в зависимости от версии Android:

  • В Android 8.0 (уровень API 26) и более поздних версиях приложения могут показывать рекомендации в одном или нескольких каналах, которые отображаются в отдельных строках. Один канал (канал по умолчанию) всегда виден. Пользователь может найти и добавить другие каналы на главный экран. Узнайте, как создавать каналы рекомендаций на главном экране.
  • В версиях до Android 8.0 Android TV показывает все рекомендации в одной строке, которая всегда видна на экране. Узнайте, как создать строку рекомендаций на главном экране.

Чтобы рекомендации показывались на всех версиях Android TV, в приложении нужно реализовать оба API. Проверьте текущий уровень API системы и используйте подходящий API, чтобы создать строку рекомендаций или каналы.

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // Use the home screen recommendation channels API.
} else {
    // Use the recommendations row API.
}

Если ваше приложение было скомпилировано с использованием уровня API 25 или более раннего, оно все равно может работать на Android TV с уровнем 26. Старый способ работы с рекомендациями совместим с новыми версиями, но имеет ограничения:

  • Строка рекомендаций автоматически преобразуется и появляется на главном экране в виде нового канала.
  • Программы на преобразованном канале реагируют на обновления из вашего сервиса рекомендаций, но пользователь не может использовать интерфейс телевизора для управления программами на канале (добавлять/удалять программы, копировать программы на канал "Смотреть дальше").
  • Если вы обновите приложение до уровня API 26, преобразованный канал по-прежнему будет показываться на телевизорах с уровнем API 26. Телевизор удаляет преобразованный канал с экрана, когда приложение впервые показывает канал, созданный с помощью нового API. Это происходит сразу, если приложение создает канал по умолчанию, или позже, когда пользователь выбирает и добавляет любой другой канал, созданный вашим приложением.