Recommander des contenus sur l'écran d'accueil

L'écran d'accueil d'Android TV affiche des contenus recommandés selon les chaînes et programmes. Les chaînes s'affichent sur l'écran d'accueil sous forme de lignes individuelles. des fiches qui affichent tous les programmes disponibles pour cette chaîne.

Votre application doit avoir au moins une version. La première chaîne l'application crée sa version par défaut, et Android TV affiche automatiquement cette chaîne sur l'écran d'accueil. Votre application peut proposer d'autres chaînes, mais l'utilisateur doit sélectionner et approuver ces chaînes ; avant de les ajouter à l'écran d'accueil.

Si votre application propose des séries TV, des films ou d'autres contenus vidéo, nous vous recommandons d'effectuer les actions suivantes : Ils sont compatibles avec les aperçus vidéo. à la chaîne "Ma sélection". La chaîne "Ma sélection" est contrôlée par le système Android. Votre application peut ajouter les programmes en rapport avec l'utilisateur vers cette chaîne, tels que les programmes que l'utilisateur a marqués comme intéressantes, qui ont été interrompues au milieu ou qui ont un rapport avec le contenu que l'internaute regarde (par exemple, le prochain épisode d'une série ou la prochaine saison d'une afficher).

Assurer la compatibilité

L'écran d'accueil affiche les recommandations de deux manières différentes en fonction du version d'Android:

  • Sur Android 8.0 (niveau d'API 26) et versions ultérieures, les applications peuvent afficher des recommandations dans un ou de chaînes qui apparaissent sur des lignes distinctes. Un canal (canal par défaut) apparaît toujours. L'utilisateur peut découvrir les autres chaînes et les ajouter à sa maison l'écran. Découvrez comment créer des canaux de recommandation. sur l'écran d'accueil.
  • Dans les versions antérieures à Android 8.0, Android TV affiche toutes les recommandations au même endroit de recommandations qui s'affiche toujours à l'écran. Découvrez comment créer le ligne de recommandations sur la page d'accueil l'écran.

Pour pouvoir afficher des recommandations sur toutes les versions d'Android TV, votre appli doit implémenter les deux API de recommandation. Tester le niveau d'API actuel du système utiliser l'API appropriée pour créer la ou les lignes de recommandations.

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
}

Si votre application a été compilée à l'aide du niveau d'API 25 ou d'une version antérieure, elle peut toujours s'exécuter sur Android TV au niveau 26. L'ancien comportement des recommandations est rétrocompatible, mais soumis à des contraintes:

  • La ligne de recommandations est automatiquement convertie et s'affiche en tant que sur l'écran d'accueil.
  • Les programmes de la chaîne convertie répondent aux mises à jour de votre service de recommandation, mais l'utilisateur ne peut pas utiliser l'UI du téléviseur pour manipuler les programmes de la chaîne (ajout/suppression de programmes, copie de programmes sur la chaîne "Ma sélection").
  • Si vous mettez à jour l'application vers le niveau d'API 26, la version convertie apparaît toujours sur les téléviseurs exécutant le niveau d'API 26. Le téléviseur supprime la chaîne convertie l'écran la première fois que votre application affiche un canal créé avec la nouvelle API. Cela se produit immédiatement si l'application crée un canal par défaut, ou plus tard, lorsque l'utilisateur sélectionne et ajoute un autre canal créé par votre application.