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 dall'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 integrarla con il canale Cosa guardare. Il canale Cosa guardare è controllato dal sistema Android. La tua app può aggiungere a questo canale programmi correlati all'utente, ad esempio programmi che l'utente ha contrassegnato come interessanti, che ha interrotto la visione a metà o che sono correlati ai contenuti che sta guardando (ad esempio l'episodio successivo di una serie o la stagione successiva di un programma).
Garantire la compatibilità
La schermata Home mostra i consigli 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 consigli in uno o più canali che vengono 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 consigli nella schermata Home.
- Prima di Android 8.0, Android TV mostrava tutti i consigli in una singola riga di consigli che veniva sempre visualizzata sullo schermo. Scopri come creare la riga di consigli nella schermata Home.
Per poter mostrare i consigli su tutte le versioni di Android TV, la tua app deve implementare entrambe le API di consigli. Verifica il livello API di sistema attuale e utilizza l'API appropriata per creare la riga o i canali di consigli.
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
}
Se la tua app è stata compilata utilizzando il livello API 25 o precedente, può comunque essere eseguita su Android TV al livello 26. Il vecchio comportamento dei consigli è compatibile con le versioni precedenti, ma è limitato:
- La riga dei consigli viene convertita automaticamente e visualizzata come un nuovo canale nella schermata Home.
- I programmi sul canale convertito rispondono agli aggiornamenti del tuo servizio di consigli, ma l'utente non può utilizzare l'interfaccia utente 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 la tua app mostra un canale creato con la nuova API. Questa operazione viene eseguita immediatamente se l'app crea un canale predefinito, o in un secondo momento quando l'utente seleziona e aggiunge qualsiasi altro canale creato dalla tua app.