Recommander des contenus sur l'écran d'accueil

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

Votre application doit comporter au moins un canal. La première chaîne créée par votre application devient sa chaîne par défaut, et Android TV l'affiche automatiquement sur l'écran d'accueil. Votre application peut proposer d'autres chaînes, mais l'utilisateur doit les sélectionner et les approuver avant qu'elles ne soient ajoutées à l'écran d'accueil.

Si votre application propose des programmes TV, des films ou d'autres contenus vidéo, nous vous recommandons d'activer les aperçus vidéo et de l'intégrer à la chaîne "À regarder ensuite". La chaîne "À regarder ensuite" est contrôlée par le système Android. Votre application peut ajouter des programmes liés à l'utilisateur à cette chaîne, par exemple des programmes que l'utilisateur a marqués comme intéressants, qu'il a mis en pause ou qui sont liés au contenu qu'il regarde (comme le prochain épisode ou la prochaine saison d'une série).

Assurer la compatibilité

L'écran d'accueil affiche les recommandations de deux manières différentes selon la version d'Android :

  • Sur Android 8.0 (niveau d'API 26) ou version ultérieure, les applications peuvent afficher des recommandations dans une ou plusieurs chaînes qui s'affichent sur des lignes distinctes. Un canal (le canal par défaut) s'affiche toujours. L'utilisateur peut découvrir et ajouter les autres chaînes à son écran d'accueil. Découvrez comment créer des canaux de recommandations sur l'écran d'accueil.
  • Avant Android 8.0, Android TV affichait toutes les recommandations sur une seule ligne qui apparaissait toujours à l'écran. Découvrez comment créer la ligne de recommandations sur l'écran d'accueil.

Pour pouvoir afficher des recommandations sur toutes les versions d'Android TV, votre application doit implémenter les deux API de recommandation. Testez le niveau d'API du système actuel et utilisez l'API appropriée pour créer la ligne ou les canaux de recommandations.

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 limité :

  • La ligne de recommandations est automatiquement convertie et apparaît comme une nouvelle chaîne 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'interface utilisateur du téléviseur pour manipuler les programmes de la chaîne (ajouter/supprimer des programmes, copier des programmes sur la chaîne "À regarder ensuite").
  • Si vous mettez à jour l'application vers le niveau d'API 26, la chaîne convertie s'affiche toujours sur les téléviseurs exécutant l'API 26. Le téléviseur supprime la chaîne convertie de l'écran la première fois que votre application affiche une chaîne créée avec la nouvelle API. Cela se produit immédiatement si l'application crée une chaîne par défaut, ou plus tard lorsque l'utilisateur sélectionne et ajoute une autre chaîne créée par votre application.