Ekran główny Androida TV wyświetla rekomendowane treści za pomocą kanałów i programów. Kanały są wyświetlane jako osobne wiersze na ekranie głównym z kartami, na których znajdują się wszystkie dostępne programy z danego kanału.
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ądów wideo i integrację z kanałem Następne. Kanał Następne jest kontrolowany przez system Android. Twoja aplikacja może dodawać do tego kanału programy związane z użytkownikiem, np. programy, które użytkownik oznaczył jako interesujące, które przerwał w trakcie oglądania lub które są powiązane z oglądanymi przez niego treściami (np. następny odcinek serialu lub następny sezon programu).
Zapewnienie zgodności
Ekran główny wyświetla rekomendacje na 2 sposoby w zależności od wersji Androida:
- W Androidzie 8.0 (interfejs API na poziomie 26) i nowszych aplikacje mogą wyświetlać rekomendacje w co najmniej 1 kanale, który pojawia się w osobnym wierszu. Zawsze wyświetla się 1 kanał (domyślny). Użytkownik może odkrywać i dodawać inne kanały do ekranu głównego. Dowiedz się, jak tworzyć kanały rekomendacji na ekranie głównym.
- W Androidzie TV w wersji starszej niż 8.0 wszystkie rekomendacje są wyświetlane w jednym wierszu, który zawsze pojawia się na ekranie. Dowiedz się, jak utworzyć wiersz rekomendacji na ekranie głównym.
Aby móc wyświetlać rekomendacje we wszystkich wersjach Androida TV, aplikacja powinna implementować oba interfejsy API rekomendacji. Sprawdź 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 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. Stare zachowanie rekomendacji jest zgodne z nowszymi wersjami, ale ograniczone:
- Wiersz rekomendacji jest automatycznie konwertowany i wyświetlany 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 manipulowania programami na kanale (dodawania i usuwania programów, kopiowania programów do kanału Następne).
- Jeśli zaktualizujesz aplikację do interfejsu API na poziomie 26, przekonwertowany kanał nadal będzie się wyświetlać 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, jeśli aplikacja utworzy kanał domyślny, lub później, gdy użytkownik wybierze i doda dowolny inny kanał utworzony przez Twoją aplikację.