Consignes de "Ma sélection" pour les développeurs d'applications

Suivez ces consignes lorsque vous insérez du contenu dans la chaîne "Ma sélection".

Types de contenus à inclure sur la chaîne "Ma sélection"

Limitez les ajouts programmatiques de votre application aux films et séries TV traditionnels. N'ajoutez pas d'extraits ni d'autres contenus courts.

Inclure les films mis en pause

Ajoutez des films mis en pause à la chaîne "Ma sélection" avec TYPE_MOVIE. Un film est interrompu s'il a commencé, mais n'est pas terminé, conformément aux consignes suivantes:

  • Un film commence si l'utilisateur regarde plus de 3% ou 2 minutes, selon le code temporel antérieur.
  • Un film est terminé si le générique de fin commence. Dans ce cas, ne l'ajoutez pas à la chaîne "Ma sélection". Vous pouvez déterminer cet état à l'aide d'une technologie qui détecte automatiquement le générique de fin ou utilise une approximation basée sur la longueur du contenu.

Inclure les épisodes mis en pause

Ajoutez des épisodes de séries TV mis en pause à la chaîne "Ma sélection" à l'aide de TYPE_TV_EPISODE. Un épisode est inachevé s'il a commencé, mais n'est pas terminé conformément aux consignes suivantes:

  • Un épisode démarre si l'utilisateur regarde plus de deux minutes.
  • Un épisode est terminé si le générique de fin commence. Dans ce cas, ne l'ajoutez pas à la chaîne "Ma sélection". Vous pouvez déterminer cet état à l'aide d'une technologie qui détecte automatiquement le générique de fin ou utilisez une approximation basée sur la durée du contenu, par exemple moins de trois minutes restantes dans un épisode.

Gérer les nouveaux épisodes de séries TV et les prochains épisodes

Ajoutez de nouveaux épisodes et les prochains épisodes de séries que l'utilisateur a commencés, en fonction des consignes suivantes, à la chaîne "Ma sélection" à l'aide de TYPE_TV_EPISODE:

  • L'utilisateur démarre une série s'il regarde plus de deux minutes ou une minute après la fin de l'introduction d'un épisode de la série.
  • Si l'utilisateur commence une série et termine un épisode, et que l'épisode suivant est disponible dans votre service, ajoutez le prochain épisode à la chaîne "Ma sélection" avec WATCH_NEXT_TYPE_NEXT.
  • Si l'utilisateur a consulté tous les épisodes actuels d'une série et qu'une nouvelle saison ou un nouvel épisode devient disponible, ajoutez ce nouvel épisode à la chaîne "Ma sélection" avec WATCH_NEXT_TYPE_NEW. Ajoutez le nouvel épisode, peu importe le temps écoulé depuis que l'utilisateur a regardé la série pour la dernière fois (par exemple, au bout d'un an ou plus).

Quand ajouter un élément à la chaîne "Ma sélection"

Ajoutez des contenus mis en pause et de nouveaux épisodes de séries déjà regardées à la chaîne "Ma sélection", conformément aux consignes ci-dessous.

Quand ajouter du contenu mis en pause

Lorsqu'un utilisateur n'a pas terminé un contenu, ajoutez-le immédiatement à la chaîne "Ma sélection" dans les cas suivants:

  • L'utilisateur quitte l'application sur Android TV.
  • L'utilisateur met en pause ou arrête la lecture d'un contenu pendant plus de cinq minutes.

Dans ces scénarios, publiez immédiatement tout contenu mis en pause, avec une latence maximale de 5 secondes. Par exemple, lorsque l'utilisateur quitte l'application Android TV, publiez tous les éléments non terminés à l'aide de l'API Watch Next dans les cinq secondes.

Publiez tout contenu mis en pause sur Android TV à l'aide de l'API Watch Next, quel que soit l'endroit où le visionnage a eu lieu. Par exemple, si l'utilisateur regarde un film dans son navigateur Chrome et le met en pause, l'application sur Android TV doit publier le contenu inachevé sur Android TV immédiatement, avec une latence maximale de 5 secondes.

Quand ajouter de nouveaux épisodes

Ajoutez immédiatement les nouveaux épisodes d'une série déjà regardée lorsque toutes les conditions suivantes sont remplies:

  • Le nouvel épisode est disponible sur votre service.
  • L'utilisateur termine l'épisode précédent.
  • L'utilisateur est autorisé à regarder le nouvel épisode.

Ajoutez le nouvel épisode, quelle que soit la durée écoulée depuis que l'utilisateur a regardé la série pour la dernière fois (par exemple, au bout d'un an ou plus).

Éligibilité des mises à jour du contenu et de l'interface utilisateur

L'utilisateur doit interagir avec le contenu de votre application pour qu'il puisse être publié sur la chaîne "Ma sélection".

N'ajoutez pas plus d'un épisode de la même série TV. Par exemple, n'ajoutez pas un épisode inachevé et un nouvel épisode de la même série.

Ne mettez pas à jour tous les éléments de la ligne Ma sélection lorsqu'un élément change. Modifiez uniquement l'élément avec lequel l'utilisateur a interagi depuis la dernière mise à jour.

Données à inclure pour un élément "Ma sélection"

Incluez les informations suivantes pour chaque élément "Ma sélection" :

  • Type "Ma sélection"
  • Dernière position de lecture
  • Durée
  • Durée du dernier engagement
  • Attributs de programme vidéo: en plus des attributs obligatoires indiqués dans le tableau des attributs des programmes vidéo, l'attribut Content ID doit être défini pour chaque programme vidéo. L'attribut Content ID doit correspondre à l'ID interne que vous indiquez dans le flux Actions multimédias. Cela permet à Android TV de rapprocher l'élément plus efficacement et de fournir aux utilisateurs une fonctionnalité offrant un niveau de confiance élevé.

Supprimer des contenus de la chaîne "Ma sélection"

Le contenu est supprimé une fois que l'utilisateur a fini de regarder un film ou qu'aucun épisode non visionné n'est disponible pour une série TV.