La schermata Home di Android TV mostra i contenuti consigliati utilizzando canali e programmi. I canali vengono visualizzati come singole righe nella schermata Home, con schede che mostrano tutti i programmi disponibili per quel canale.
La tua app deve avere almeno un canale. Il primo canale creato dalla tua app diventa il suo canale predefinito e Android TV lo visualizza automaticamente nella schermata Home. La tua app può offrire altri canali, ma l'utente deve selezionarli e approvarli prima che vengano aggiunti alla schermata Home.
Se la tua app include programmi TV, film o altri contenuti video, ti consigliamo di supportare le anteprime video e di eseguire l'integrazione con il canale Guarda successivo. Il canale Cosa guardare è controllato dal sistema Android. La tua app può aggiungere programmi correlati all'utente a questo canale, ad esempio programmi che l'utente ha contrassegnato come interessanti, che ha interrotto a metà o che sono correlati ai contenuti che l'utente sta guardando (ad esempio l'episodio successivo di una serie o la stagione successiva di un programma).
Assicurati la compatibilità
La schermata Home mostra i contenuti consigliati in due modi diversi a seconda della versione di Android:
- In Android 8.0 (livello API 26) e versioni successive, le app possono mostrare i contenuti consigliati in uno o più canali visualizzati su righe separate. Viene sempre visualizzato un canale (il canale predefinito). L'utente può scoprire e aggiungere gli altri canali alla schermata Home. Scopri come creare canali di contenuti consigliati nella schermata Home.
- Prima di Android 8.0, Android TV mostrava tutti i contenuti consigliati in un'unica riga di contenuti consigliati che appariva sempre sullo schermo. Scopri come creare la riga dei contenuti consigliati nella schermata Home.
Per poter mostrare i contenuti consigliati su tutte le versioni di Android TV, la tua app deve implementare entrambe le API di contenuti consigliati. Testa il livello API di sistema corrente e utilizza l'API appropriata per creare la riga o i canali dei contenuti consigliati.
if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) { // Use the home screen recommendation channels API. } else { // Use the recommendations row API. }
Se la tua app è stata compilata utilizzando il livello API 25 o versioni precedenti, può comunque essere eseguita su Android TV nel livello 26. Il comportamento dei suggerimenti precedenti è compatibile con le versioni successive, ma limitato:
- La riga dei contenuti consigliati viene convertita automaticamente e visualizzata come nuovo canale nella schermata Home.
- I programmi sul canale convertito rispondono agli aggiornamenti del tuo servizio di contenuti consigliati, ma l'utente non può utilizzare la UI della TV per manipolare i programmi sul canale (aggiungere/rimuovere programmi, copiare programmi nel canale "Cosa guardare").
- Se aggiorni l'app al livello API 26, il canale convertito viene comunque visualizzato sulle TV con API 26. La TV rimuove il canale convertito dallo schermo la prima volta che l'app visualizza un canale creato con la nuova API. Ciò avviene immediatamente se l'app crea un canale predefinito o in un secondo momento quando l'utente seleziona e aggiunge un altro canale creato dalla tua app.