Na ekranie głównym Androida TV wyświetlane są polecane treści z kanałów i programów. Kanały są wyświetlane jako pojedyncze wiersze na ekranie głównym, z kartami, które pokazują wszystkie dostępne programy na danym kanale.
Aplikacja powinna mieć co najmniej 1 kanał. Pierwszy kanał utworzony przez aplikację staje się jej kanałem domyślnym, a Android TV automatycznie wyświetla go na ekranie głównym. Aplikacja może oferować inne kanały, ale użytkownik musi je wybrać i zatwierdzić, zanim zostaną dodane do ekranu głównego.
Jeśli Twoja aplikacja zawiera programy telewizyjne, filmy lub inne treści wideo, zalecamy obsługę podglądu filmów i integrację z kanałem Warte obejrzenia. Kanał Warte obejrzenia jest kontrolowany przez system Android. Aplikacja może dodawać do tego kanału programy związane z użytkownikiem, np. programy, które użytkownik oznaczył jako interesujące, przestał oglądać w połowie lub które są powiązane z treściami oglądanymi przez użytkownika (np. następny odcinek serialu lub następny sezon programu).
Zapewnianie zgodności
Ekran główny wyświetla rekomendacje na 2 różne sposoby w zależności od wersji Androida:
- W Androidzie 8.0 (poziom interfejsu API 26) i nowszych aplikacje mogą wyświetlać rekomendacje w co najmniej 1 kanale, które pojawiają się w osobnych wierszach. Zawsze wyświetla się jeden kanał (domyślny). Użytkownik może odkryć i dodać inne kanały do ekranu głównego. Dowiedz się, jak utworzyć kanały rekomendacji na ekranie głównym.
- Przed Androidem 8.0 Android TV wyświetlał wszystkie rekomendacje w jednym wierszu, który zawsze był widoczny na ekranie. Dowiedz się, jak utworzyć wiersz rekomendacji na ekranie głównym.
Aby wyświetlać rekomendacje we wszystkich wersjach Androida TV, aplikacja powinna implementować oba interfejsy API rekomendacji. Przetestuj bieżący poziom interfejsu API systemu i użyj odpowiedniego interfejsu API, aby utworzyć wiersz lub kanały rekomendacji.
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 aplikacja została skompilowana przy użyciu interfejsu API na poziomie 25 lub niższym, nadal może działać na Androidzie TV na poziomie 26. Stary sposób działania rekomendacji jest zgodny z nowymi wersjami, ale ma ograniczenia:
- Wiersz rekomendacji jest automatycznie konwertowany i pojawia się jako nowy kanał na ekranie głównym.
- Programy na przekonwertowanym kanale reagują na aktualizacje z usługi rekomendacji, ale użytkownik nie może używać interfejsu telewizora do zarządzania programami na kanale (dodawania/usuwania programów, kopiowania programów do kanału Warte obejrzenia).
- Jeśli zaktualizujesz aplikację do interfejsu API na poziomie 26, przekonwertowany kanał będzie nadal wyświetlany na telewizorach z interfejsem API na poziomie 26. Telewizor usunie przekonwertowany kanał z ekranu, gdy aplikacja po raz pierwszy wyświetli kanał utworzony za pomocą nowego interfejsu API. Dzieje się tak natychmiast, gdy aplikacja tworzy kanał domyślny, lub później, gdy użytkownik wybierze i doda dowolny inny kanał utworzony przez aplikację.