Aggiungere programmi al canale Guarda in seguito

Il canale Cosa guardare è la seconda riga che viene visualizzata nella schermata Home, dopo la riga delle app. Il sistema crea e gestisce questo canale. La tua app può aggiungere programmi al canale Da guardare: programmi che l'utente ha contrassegnato come interessanti, che ha interrotto la visione a metà o che sono correlati ai contenuti che sta guardando (ad esempio l'episodio successivo di una serie o la stagione successiva di un programma).

Il canale Da guardare presenta alcuni vincoli: la tua app non può spostare, rimuovere o nascondere la riga del canale Da guardare.

Passaggi

L'inserimento di programmi nel canale Cosa guardare è simile all'inserimento di programmi nel tuo canale. Per maggiori dettagli su Watch Next, consulta le sezioni seguenti.

Quando inserisci contenuti nel canale Da guardare, devi seguire queste linee guida:

Seleziona un tipo di programma

Esistono quattro tipi di programmi della sezione Guarda il prossimo. Seleziona il tipo appropriato:

Tipo Note
WATCH_NEXT_TYPE_CONTINUE L'utente ha interrotto la visione dei contenuti.
WATCH_NEXT_TYPE_NEXT È disponibile il programma successivo di una serie che l'utente sta guardando. Ad esempio, se l'utente sta guardando l'episodio 3 di una serie, l'app può suggerire di guardare l'episodio 4.
WATCH_NEXT_TYPE_NEW Sono ora disponibili nuovi contenuti che seguono chiaramente ciò che l'utente sta guardando. Ad esempio, l'utente sta guardando l'episodio numero 5 di una serie e l'episodio 6 diventa disponibile per la visione.
WATCH_NEXT_TYPE_WATCHLIST Inserito dal sistema o dall'app quando l'utente salva un programma.

Per maggiori informazioni, consulta Attributi di Cosa guardare.

Utilizzare lo strumento per la creazione di WatchNextProgram

Utilizza un WatchNextProgram.Builder. Per saperne di più, consulta Attributi Guarda il prossimo.

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());

Utilizza TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId) per creare il Uri necessario per aggiornare un programma della sezione Cosa guardare.

Quando l'utente aggiunge un programma al canale Cosa guardare, il sistema copia il programma nella riga. Invia l'intent TvContractCompat.ACTION_PREVIEW_PROGRAM_ADDED_TO_WATCH_NEXT per notificare all'app che il programma è stato aggiunto. L'intent include due extra: l'ID programma che è stato copiato e l'ID programma creato per il programma nel canale Cosa guardare.