На главном экране Android TV отображается рекомендуемый контент с использованием каналов и программ . Каналы отображаются в виде отдельных строк на главном экране с карточками, отображающими все доступные программы для этого канала.
В вашем приложении должен быть хотя бы один канал. Первый канал, созданный вашим приложением, становится каналом по умолчанию , и Android TV автоматически отображает этот канал на главном экране. Ваше приложение может предлагать другие каналы, но пользователь должен выбрать и одобрить эти каналы, прежде чем они будут добавлены на главный экран.
Если в вашем приложении представлены телешоу, фильмы или другой видеоконтент, мы рекомендуем поддерживать предварительный просмотр видео и интегрировать его с каналом Watch Next . Канал Watch Next управляется системой 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
}
Ява
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. Это происходит немедленно, если приложение создает канал по умолчанию , или позже, когда пользователь выбирает и добавляет любой другой канал, созданный вашим приложением.