Ajouter des programmes à la chaîne "Ma sélection"

La chaîne "Ma sélection" est la deuxième ligne qui s'affiche sur l'écran d'accueil, après la ligne des applications. Le système crée et gère cette chaîne. Votre application peut ajouter des programmes à la chaîne "Ma sélection", c'est-à-dire des programmes que l'utilisateur a marqués comme intéressants, qu'il a arrêtés de regarder au milieu ou qui sont liés au contenu qu'il regarde (comme l'épisode suivant d'une série ou la saison suivante d'une série).

La chaîne "Ma sélection" présente certaines contraintes: votre application ne peut pas déplacer, supprimer ni masquer la ligne de la chaîne "Ma sélection".

Étapes

Insérer des programmes dans la chaîne "Ma sélection" est semblable à l'insertion de programmes sur une chaîne. Consultez les sections suivantes pour en savoir plus sur "Ma sélection".

La publication sur la chaîne "Ma sélection" sur Google TV (affichée comme "Continuer à regarder") nécessite l'approbation préalable de Google via un processus de certification et utilise un traitement côté serveur pour trier les programmes en fonction de leurs attributs. Pour commencer la procédure de certification, veuillez envoyer ce formulaire en lien.

Lorsque vous insérez du contenu sur la chaîne "Ma sélection", vous devez suivre ces consignes:

Sélectionnez un type de programme

Il existe quatre types de programmes "Ma sélection". Sélectionnez le type approprié:

TypeNotes
WATCH_NEXT_TYPE_CONTINUEL'utilisateur s'est arrêté pendant le visionnage du contenu.
WATCH_NEXT_TYPE_NEXTLe prochain programme disponible dans une série que l'utilisateur regarde est disponible. Par exemple, si l'utilisateur regarde l'épisode 3 d'une série, l'application peut lui suggérer de regarder ensuite l'épisode 4.
WATCH_NEXT_TYPE_NEWDe nouveaux contenus qui suivent clairement ce que l'utilisateur regarde sont désormais disponibles. Par exemple, si l'utilisateur regarde l'épisode 5 d'une série, l'épisode 6 devient disponible.
WATCH_NEXT_TYPE_WATCHLISTElle est insérée par le système ou l'application lorsque l'utilisateur enregistre un programme.

Pour en savoir plus, consultez la section Attributs à regarder ensuite.

Utiliser le compilateur WatchNextProgram

Utilisez un WatchNextProgram.Builder. Pour en savoir plus, consultez la section Attributs "Ma sélection".

Kotlin

val builder = WatchNextProgram.Builder()
builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE)
        .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
        .setLastEngagementTimeUtcMillis(time)
        .setTitle("Title")
        .setDescription("Program description")
        .setPosterArtUri(uri)
        .setIntentUri(uri)
        .setInternalProviderId(appProgramId)

val watchNextProgramUri = context.contentResolver
        .insert(TvContractCompat.WatchNextPrograms.CONTENT_URI,
                builder.build().toContentValues())

Java

WatchNextProgram.Builder builder = new WatchNextProgram.Builder();
builder.setType(TvContractCompat.WatchNextPrograms.TYPE_MOVIE)
        .setWatchNextType(TvContractCompat.WatchNextPrograms.WATCH_NEXT_TYPE_CONTINUE)
        .setLastEngagementTimeUtcMillis(time)
        .setTitle("Title")
        .setDescription("Program description")
        .setPosterArtUri(uri)
        .setIntentUri(uri)
        .setInternalProviderId(appProgramId);

Uri watchNextProgramUri = context.getContentResolver()
        .insert(TvContractCompat.WatchNextPrograms.CONTENT_URI, builder.build().toContentValues());

Utilisez TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId) pour créer les Uri dont vous avez besoin pour mettre à jour un programme Watch Next.

Lorsque l'utilisateur ajoute un programme à la chaîne "Ma sélection", le système le copie sur la ligne. Il envoie l'intent TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT pour avertir l'application que le programme a été ajouté. L'intent inclut deux extras: l'ID de programme qui a été copié et l'ID de programme créé pour le programme dans la chaîne "Ma sélection".