L'écran d'accueil d'Android TV affiche des contenus recommandés à l'aide de chaînes et de programmes. Les chaînes se présentent sous la forme de lignes individuelles sur l'écran d'accueil, avec des fiches présentant tous les programmes disponibles pour une chaîne.
Votre application doit comporter au moins une version. Le premier canal créé par votre application devient sa chaîne 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 les sélectionner et les approuver pour qu'elles 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 à cette chaîne des programmes liés à l'utilisateur, tels que des programmes que l'utilisateur a marqués comme intéressants, qui ont été arrêtés de regarder au milieu ou qui sont en rapport avec le contenu qu'il regarde (comme l'épisode suivant d'une série ou la saison suivante 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:
- Sous Android 8.0 (niveau d'API 26) et versions ultérieures, les applications peuvent afficher des recommandations sur un ou plusieurs canaux qui apparaissent sur des lignes distinctes. Un canal (le canal par défaut) apparaît toujours. L'utilisateur peut découvrir les autres chaînes et les ajouter à son écran d'accueil. Découvrez comment créer des canaux de recommandation sur l'écran d'accueil.
- Avant Android 8.0, Android TV affiche toutes les recommandations sur une seule ligne de recommandations qui apparaît toujours à l'écran. Découvrez comment créer la ligne de recommandation 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 actuel du système et utilisez l'API appropriée pour créer la ligne ou les canaux de recommandation.
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 en tant que nouveau canal 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 "Ma sélection").
- Si vous mettez à jour l'application vers le niveau d'API 26, le canal converti s'affiche toujours sur les téléviseurs exécutant l'API 26. Le téléviseur supprime le canal converti de 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 une version par défaut ou ultérieurement lorsque l'utilisateur sélectionne et ajoute un autre canal créé par votre application.