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 l'aggiunta programmatica della tua app a film e programmi TV tradizionali. Non aggiungere clip e altri contenuti nel formato breve.

Includi film da terminare

Aggiungi film da completare al canale Guarda in seguito utilizzando TYPE_MOVIE. Un filmato non viene completato se è stato avviato ma non completato in base alle seguenti linee guida:

  • Un film viene avviato se l'utente guarda più del 3% o 2 minuti, a seconda del timestamp che si verifica prima.
  • Un film finisce se iniziano i titoli di coda. In questo caso, non aggiungerlo al canale Guarda in seguito. Puoi determinare questo stato utilizzando una tecnologia che rilevi automaticamente i crediti finali o utilizzi un'approssimazione basata sulla lunghezza del contenuto.

Includi puntate TV da finire

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

  • Una puntata viene avviata se l'utente guarda più di 2 minuti.
  • Una puntata termina se iniziano i titoli di coda. In questo caso, non aggiungerlo al canale Guarda in seguito. Puoi determinare questo stato utilizzando una tecnologia che rilevi automaticamente i riconoscimenti finali o utilizzi un'approssimazione basata sulla durata dei contenuti, ad esempio meno di 3 minuti dalla fine di una puntata.

Gestire le nuove puntate e le prossime puntate TV

Aggiungi al canale Guarda in seguito utilizzando le nuove puntate e le puntate successive delle serie avviate dall'utente, in base alle seguenti linee guida, utilizzando TYPE_TV_EPISODE:

  • L'utente avvia una serie se guarda più di 2 minuti o 1 minuto dopo il completamento dell'introduzione di qualsiasi episodio della serie.
  • Se l'utente inizia una serie e ne termina una e la puntata successiva è disponibile sul tuo servizio, aggiungi l'episodio successivo al canale Guarda successivo utilizzando WATCH_NEXT_TYPE_NEXT.
  • Se l'utente è completamente aggiornato su tutte le puntate correnti di una serie e diventa disponibile una nuova stagione o un nuovo episodio, aggiungi questo nuovo episodio al canale Guarda in seguito utilizzando WATCH_NEXT_TYPE_NEW. Aggiungi la nuova puntata a prescindere da quanto 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 Che cosa guardare dopo

Aggiungi al canale Guarda in seguito i contenuti da completare e i nuovi episodi delle serie già visualizzate in base alle seguenti linee guida.

Quando aggiungere contenuti da completare

Quando un utente ha dei contenuti da completare, aggiungili subito al canale Guarda successivo 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 qualsiasi contenuto non completato, con una latenza massima di 5 secondi. Ad esempio, quando l'utente esce dall'app Android TV, pubblica tutti gli elementi non completati utilizzando l'API Guarda successivo entro 5 secondi.

Pubblica i contenuti non completati 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 non completati su Android TV, con una latenza massima di 5 secondi.

Quando aggiungere nuove puntate

Aggiungi immediatamente le nuove puntate di una serie guardata in precedenza se sussistono 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 a prescindere da quanto tempo è trascorso dall'ultima volta che l'utente ha guardato la serie, ad esempio dopo un anno o più.

Idoneità degli aggiornamenti all'interfaccia utente e dei contenuti

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

Non aggiungere più di una puntata della stessa serie TV. Ad esempio, non aggiungere un episodio da completare e un nuovo episodio della stessa serie.

Non aggiornare tutti gli elementi nella riga Prossimi contenuti quando viene modificato un elemento. 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 in seguito:

  • Tipo Guarda successivo
  • Ultima posizione di riproduzione
  • Durata
  • Data/ora ultimo coinvolgimento
  • Attributi dei programmi video: oltre agli attributi obbligatori contrassegnati nella tabella degli attributi del programma video, l'attributo di Content ID deve essere impostato per ogni programma video. L'attributo Content ID deve corrispondere all'ID interno fornito nel feed Azioni multimediali. In questo modo Android TV riconcilia l'asset in modo più efficace e offre agli utenti una funzionalità ad alta affidabilità.

Rimuovere contenuti dal canale Guarda in seguito

Rimuovi i contenuti quando l'utente finisce di guardare un film o non ci sono episodio non guardati disponibili per una serie TV.