Consigliare contenuti sulla schermata Home

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 canale predefinito e Android TV lo mostra automaticamente nella schermata Home. La tua app può offrire altri canali, ma l'utente deve selezionare e approvare questi canali 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 integrarli con il canale Guarda successivo. Il canale Guarda in seguito è controllato dal sistema Android. La tua app può aggiungere a questo canale programmi correlati all'utente, ad esempio programmi contrassegnati come interessanti dall'utente, che hanno interrotto la visione al centro o correlati ai contenuti che l'utente sta guardando (ad esempio la puntata successiva 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 consigli in uno o più canali in righe separate. Un canale (il canale predefinito) viene sempre visualizzato. L'utente può scoprire e aggiungere gli altri canali alla schermata Home. Scopri come creare canali di consigli sulla schermata Home.
  • Prima di Android 8.0, Android TV mostrava tutti i consigli in un'unica riga di consigli, sempre visualizzata sullo schermo. Scopri come creare la riga di consigli nella schermata Home.

Per poter mostrare consigli su tutte le versioni di Android TV, la tua app deve implementare entrambe le API per i suggerimenti. Testa l'attuale livello API di sistema e utilizza l'API appropriata per creare la riga o i canali di suggerimento.

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 nel livello 26. Il comportamento precedente dei suggerimenti è compatibile con le modalità future, ma è limitato:

  • La riga dei consigli viene convertita automaticamente e appare come nuovo canale nella schermata Home.
  • I programmi del canale convertito rispondono agli aggiornamenti del tuo servizio di suggerimenti, ma l'utente non può utilizzare l'interfaccia utente della TV per manipolare i programmi sul canale (aggiungere/rimuovere programmi, copiare programmi sul canale Guarda in seguito).
  • Se aggiorni l'app al livello API 26, il canale convertito continua a essere visualizzato sulle TV con l'API 26. La TV rimuove il canale convertito dallo schermo la prima volta che l'app mostra un canale creato con la nuova API. Questo accade immediatamente se l'app crea un canale predefinito o in un secondo momento, quando l'utente seleziona e aggiunge qualsiasi altro canale creato dall'app.