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:
- Linee guida di Cosa guardare per gli sviluppatori di app
- Linee guida per la sezione Da guardare per i fornitori di servizi TV
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.