Linee guida di Watch Next per gli sviluppatori di app

Segui queste linee guida quando inserisci contenuti nel canale Guarda successivo.

Tipi di contenuti da includere nel canale Guarda successivo

Limita le aggiunte programmatiche della tua app a film e programmi TV tradizionali. Non aggiungere clip e altri contenuti nel formato breve.

Includi i film da finire

Aggiungi i film da finire al canale Guarda successivo utilizzando TYPE_MOVIE. Un film è da finire se è stato iniziato ma non terminato in base alle seguenti linee guida:

  • Un film è iniziato se l'utente guarda più del 3% o 2 minuti, a seconda del timestamp precedente.
  • Un film è terminato se iniziano i titoli di coda. In questo caso, non aggiungerlo al canale Guarda successivo. Puoi determinare questo stato utilizzando una tecnologia che rileva automaticamente i titoli di coda o utilizzando un'approssimazione basata sulla durata dei contenuti.

Includi le puntate TV da finire

Aggiungi le puntate TV da finire al canale Guarda successivo utilizzando TYPE_TV_EPISODE. Una puntata è da finire se è stata iniziata ma non terminata in base alle seguenti linee guida:

  • Una puntata è iniziata se l'utente guarda più di 2 minuti.
  • Una puntata è terminata se iniziano i titoli di coda. In questo caso, non aggiungerla al canale Guarda successivo. Puoi determinare questo stato utilizzando una tecnologia che rileva automaticamente i titoli di coda o utilizzando un'approssimazione basata sulla durata dei contenuti, ad esempio se mancano meno di 3 minuti alla fine di una puntata.

Gestire le nuove puntate TV e le puntate TV successive

Aggiungi le nuove puntate e le puntate successive delle serie che l'utente ha iniziato, in base a le seguenti linee guida, al canale Guarda successivo utilizzando TYPE_TV_EPISODE:

  • L'utente inizia una serie se guarda più di 2 minuti o 1 minuto dopo il completamento dell'introduzione di una puntata della serie.
  • Se l'utente inizia una serie e termina una puntata e la puntata successiva della serie è disponibile nel tuo servizio, aggiungi questa puntata successiva al canale Guarda successivo utilizzando WATCH_NEXT_TYPE_NEXT.
  • Se l'utente ha guardato tutte le puntate attuali di una serie e diventa disponibile una nuova stagione o puntata, aggiungi questa nuova puntata al canale Guarda successivo utilizzando WATCH_NEXT_TYPE_NEW. Aggiungi la nuova puntata indipendentemente dal tempo trascorso dall'ultima volta che l'utente ha guardato la serie, ad esempio dopo un anno o più.

Quando aggiungere un elemento al canale Guarda successivo

Aggiungi i contenuti da finire e le nuove puntate delle serie visualizzate in precedenza al canale Guarda successivo in base alle seguenti linee guida.

Quando aggiungere i contenuti da completare

Quando un utente ha un contenuto da finire, aggiungilo al canale Guarda successivo immediatamente quando si verifica una delle seguenti condizioni:

  • L'utente esce dall'app su Android TV.
  • L'utente mette in pausa o interrompe la riproduzione di un contenuto per più di 5 minuti.

In questi scenari, pubblica immediatamente tutti i contenuti da finire, con una latenza massima di 5 secondi. Ad esempio, quando l'utente esce dall'app Android TV, pubblica tutti gli elementi da finire utilizzando l'API Guarda successivo entro 5 secondi.

Pubblica tutti i contenuti da finire su Android TV utilizzando l'API Guarda successivo, indipendentemente da dove è avvenuta la visualizzazione. Ad esempio, se l'utente guarda un film nel browser Chrome e lo mette in pausa, l'app su Android TV deve pubblicare immediatamente i contenuti da finire su Android TV, con una latenza massima di 5 secondi.

Quando aggiungere le nuove puntate

Aggiungi immediatamente le nuove puntate di una serie guardata in precedenza quando si verificano tutte le seguenti condizioni:

  • La nuova puntata è disponibile sul tuo servizio.
  • L'utente completa la puntata precedente.
  • L'utente ha il diritto di guardare la nuova puntata.

Aggiungi la nuova puntata indipendentemente dal tempo trascorso dall'ultima volta che l'utente ha guardato la serie, ad esempio dopo un anno o più.

Idoneità dei contenuti e aggiornamenti dell'interfaccia utente

L'utente deve interagire con i contenuti all'interno della tua app affinché i contenuti siano idonei alla pubblicazione sul canale Guarda successivo.

Non aggiungere più di una puntata della stessa serie TV. Ad esempio, non aggiungere una puntata da finire e una nuova puntata della stessa serie.

Non aggiornare tutti gli elementi nella riga Prossimi contenuti quando un elemento cambia. Aggiorna solo l'elemento con cui l'utente ha interagito dall'ultimo aggiornamento.

Quali dati includere per un elemento Guarda successivo

Includi quanto segue per ogni elemento Guarda successivo:

  • Tipo di Guarda successivo
  • Ultima posizione di riproduzione
  • Durata
  • Ora dell'ultimo coinvolgimento
  • Attributi del programma video: oltre agli attributi obbligatori contrassegnati in la tabella degli attributi del programma video, l'attributo Content ID deve essere impostato per ogni programma video. L'attributo Content ID deve corrispondere all' ID interno che fornisci nel feed Azioni multimediali. In questo modo, Android TV può riconciliare la risorsa in modo più efficace e fornire agli utenti una funzionalità ad alta affidabilità.

Rimuovere contenuti dal canale Guarda successivo

Rimuovi i contenuti una volta che l'utente ha finito di guardare un film o se non è disponibile alcuna puntata non guardata per una serie TV.