L'écran d'accueil d'Android TV affiche des contenus recommandés à l'aide de chaînes et de programmes. Les chaînes s'affichent sous forme de lignes individuelles sur l'écran d'accueil, avec des fiches qui présentent tous les programmes disponibles pour cette chaîne.
Votre application doit comporter au moins une chaîne. La première chaîne que votre application crée 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 séries TV, des films ou d'autres contenus vidéo, nous vous recommandons de prendre en charge les aperçus vidéo et de l'intégrer à 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 des programmes liés à l'utilisateur à cette chaîne, comme 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 l'épisode suivant ou la saison suivante d'une série, par exemple).
Assurer la compatibilité
L'écran d'accueil affiche les recommandations de deux manières différentes selon la version d'Android :
- Sous Android 8.0 (niveau d'API 26) et versions ultérieures, les applications peuvent afficher des recommandations dans une ou plusieurs chaînes qui apparaissent sur des lignes distinctes. Une chaîne (la chaîne 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 chaînes de recommandations sur l'écran d'accueil.
- Avant Android 8.0, Android TV affiche toutes les recommandations dans une seule ligne de recommandations qui apparaît 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 recommandations. Testez le niveau d'API du système actuel et utilisez l'API appropriée pour créer la ligne ou les chaînes 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 limité :
- La ligne de recommandations est automatiquement convertie et apparaît sous forme de nouvelle chaîne sur l'écran d'accueil.
- Les programmes de la chaîne convertie répondent aux mises à jour de votre service de recommandations, 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 dans la chaîne "Ma sélection").
- Si vous mettez à jour l'application au 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.