Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
На главном экране 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. Это происходит немедленно, если приложение создает канал по умолчанию , или позже, когда пользователь выбирает и добавляет любой другой канал, созданный вашим приложением.
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-29 UTC."],[],[],null,["# Recommend content on the home screen\n\nThe Android TV *home screen* displays recommended content using *channels* and\n*programs*. Channels are displayed as individual rows on the home screen, with\ncards that display all of the available programs for that channel.\n\nYour app should have at least one channel. The first channel your\napp creates becomes its [default channel](/training/tv/discovery/recommendations-channel#default-channel),\nand Android TV displays that channel automatically on the home screen. Your app\ncan offer other channels, but the user must select and approve those channels\nbefore they are added to the home screen.\n\nIf your app features TV shows, movies, or other video content, we recommend that\nyou support [video previews](/training/tv/discovery/preview-videos) and\nintegrate with the [Watch Next channel](/training/tv/discovery/recommendations-channel#watch-next).\nThe Watch Next channel is controlled by the Android system. Your app can add\nuser-related programs to this channel, such as programs that the user marked as\ninteresting, stopped watching in the middle, or that are related to the content\nthe user is watching (like the next episode in a series or next season of a\nshow).\n\nEnsure compatibility\n--------------------\n\nThe home screen displays recommendations two different ways depending on the\nversion of Android:\n\n- In Android 8.0 (API level 26) and later, apps can show recommendations in one or more channels that appear on separate rows. One channel (the default channel) always appears. The user can discover and add the other channels to their home screen. Learn how to create [recommendation channels](/training/tv/discovery/recommendations-channel) on the home screen.\n- Before Android 8.0, Android TV shows all recommendations in a single recommendations row that always appears on the screen. Learn how to create the [recommendation row](/training/tv/discovery/recommendations-row) on the home screen.\n\nTo be able to show recommendations on all versions of Android TV, your app\nshould implement both recommendation APIs. Test the current system API level and\nuse the appropriate API to build the recommendation row or channels. \n\n### Kotlin\n\n```kotlin\nif (android.os.Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.O) {\n // Use the home screen recommendation channels API\n} else {\n // Use the recommendations row API\n}\n```\n\n### Java\n\n```java\nif (android.os.Build.VERSION.SDK_INT \u003e= Build.VERSION_CODES.O) {\n // Use the home screen recommendation channels API\n} else {\n // Use the recommendations row API\n}\n```\n\nIf your app was compiled using API level 25 or earlier, it can still run on\nAndroid TV in level 26. The old recommendations behavior is forward-compatible,\nbut constrained:\n\n- The recommendations row is automatically converted and appears as a new channel on the home screen.\n- The programs on the converted channel respond to updates from your [recommendation service](/training/tv/discovery/recommendations-row#service), but the user cannot use the TV's UI to manipulate the programs on the channel (add/remove programs, copy programs to the Watch Next channel).\n- If you update the app to API level 26, the converted channel still appears on TVs running API 26. The TV removes the converted channel from the screen the first time your app displays a channel created with the new API. This happens immediately if the app creates a [default channel](/training/tv/discovery/recommendations-channel#the_default_channel), or later when the user selects and adds any other channel created by your app.\n\n| **Note:** This forward-compatible behavior is temporary, it will be removed sometime in the future. To ensure compatibility, the best practice is to implement both APIs, as described above."]]
