Aggiungere programmi al canale Guarda in seguito

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

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

Passaggi

L'inserimento di programmi nel canale Cosa guardare è simile all'inserimento di programmi nel tuo canale. Per i dettagli specifici di Cosa guardare, consulta le sezioni seguenti.

Quando inserisci contenuti nel canale Guarda i prossimi, devi seguire queste linee guida:

Seleziona un tipo di programma

Esistono quattro tipi di programmi Cosa guardare. Seleziona il tipo appropriato:

Tipo Note
WATCH_NEXT_TYPE_CONTINUE L'utente ha interrotto la visione dei contenuti.
WATCH_NEXT_TYPE_NEXT Il programma successivo disponibile in una serie che l'utente sta guardando è disponibile. 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 saperne di più, consulta Attributi di Cosa guardare.

Utilizza il builder WatchNextProgram

Utilizza un WatchNextProgram.Builder. Per saperne di più, consulta Attributi di Cosa guardare.

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

Utilizza TvContractCompat.buildWatchNextProgramUri(long watchNextProgramId) per creare l'oggetto Uri necessario per aggiornare un programma Cosa guardare.

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