Polecaj treści na ekranie głównym

Ekran główny Androida TV wyświetla polecane treści w ramach kanałów i programów. Kanały są wyświetlane na ekranie głównym jako osobne wiersze, a karty wyświetlają wszystkie programy dostępne na danym kanale.

Aplikacja powinna mieć co najmniej 1 kanał. Pierwszy kanał utworzony przez aplikację staje się kanałem domyślnym, a Android TV wyświetla go automatycznie na ekranie głównym. Twoja aplikacja może oferować inne kanały, ale użytkownik musi je wybrać i zatwierdzić, zanim dodasz je do ekranu głównego.

Jeśli Twoja aplikacja zawiera programy telewizyjne, filmy lub inne treści wideo, zalecamy włączenie podglądów filmów i ich integrację z kanałem Warte obejrzenia. Kanałem „Warte obejrzenia” steruje system Android. Aplikacja może dodawać do tego kanału programy związane z użytkownikiem, takie jak programy, które użytkownik oznaczył jako interesujące, przestały oglądać w środku lub są związane z treściami, które ogląda (np. następny odcinek serialu lub kolejny sezon serialu).

Zapewnienie zgodności

Ekran główny wyświetla rekomendacje na 2 sposoby w zależności od wersji Androida:

  • Na Androidzie 8.0 (poziom interfejsu API 26) i nowszych aplikacje mogą wyświetlać rekomendacje w co najmniej jednym kanale, które pojawiają się w osobnych wierszach. Zawsze wyświetlany jest 1 kanał (kanał domyślny). Użytkownik może odkryć inne kanały i dodać je do swojego ekranu głównego. Dowiedz się, jak tworzyć kanały rekomendacji na ekranie głównym.
  • W wersjach starszych niż 8.0 Android TV pokazuje wszystkie rekomendacje w jednym wierszu rekomendacji, który zawsze jest widoczny na ekranie. Dowiedz się, jak utworzyć wiersz rekomendacji na ekranie głównym.

Aby móc wyświetlać rekomendacje we wszystkich wersjach Androida TV, musisz w swojej aplikacji zaimplementować oba interfejsy API rekomendacji. Przetestuj bieżący poziom interfejsu API systemu i użyj odpowiedniego interfejsu API, aby utworzyć wiersz lub kanały rekomendacji.

Kotlin

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
}

Jeśli Twoja aplikacja została skompilowana przy użyciu interfejsu API poziomu 25 lub starszego, nadal może działać na Androidzie TV na poziomie 26. Stare działanie rekomendacji jest zgodne z dalszymi działaniami, ale ma pewne ograniczenia:

  • Wiersz rekomendacji jest automatycznie konwertowany i pojawia się na ekranie głównym jako nowy kanał.
  • Programy na przekonwertowanym kanale reagują na aktualizacje pochodzące z Twojej usługi rekomendacji, ale użytkownik nie może korzystać z interfejsu telewizora do manipulowania programami na kanale (dodawać/usuwać programy, kopiować je na kanał Warte obejrzenia).
  • Jeśli zaktualizujesz aplikację do poziomu interfejsu API 26, przekonwertowany kanał będzie nadal widoczny na telewizorach z interfejsem API 26. Telewizor usunie przekonwertowany kanał z ekranu, gdy aplikacja po raz pierwszy wyświetli kanał utworzony za pomocą nowego interfejsu API. Dzieje się tak od razu, gdy aplikacja utworzy kanał domyślny, lub później, gdy użytkownik wybierze i dodaje inny kanał utworzony w aplikacji.