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

На главном экране 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
}

Java 

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 с API уровня 26. Старое поведение рекомендаций совместимо с предыдущими версиями, но имеет ограничения:

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