Tracciare la riproduzione di base in Chromecast track-core-playback-on-chromecast
Questa documentazione tratta il tracciamento nella versione 2.x dell’SDK.
-
Configurazione del tracciamento iniziale
Identifica quando l’utente attiva l’intenzione di riproduzione (l’utente fa clic su play e/o l’esecuzione automatica è attiva) e crea un’istanza
MediaObject
.Specifihe di
MediaObject
API:code language-none mediaObject = ADBMobile.media.createMediaObject(<name>, <id>, <duration>, <streamType>, <mediaType>);
Costanti
StreamType
:Costanti
MediaType
: -
Allega metadati video
Facoltativamente, puoi allegare oggetti metadati video standard e/o personalizzati alla sessione di tracciamento video attraverso variabili dei dati di contesto.
-
Metadati video standard
Implementare i metadati standard in Chromecast
note note NOTE Il collegamento dell’oggetto metadati video standard all’oggetto multimediale è facoltativo. -
Metadati personalizzati
Crea un oggetto variabile per le variabili personalizzate e lo popola con i dati del video. Ad esempio:
code language-js /* Set custom context data */ var customVideoMetadata = { isUserLoggedIn: "false", tvStation: "Sample TV station", programmer: "Sample programmer" };
-
-
Tracciare l’intenzione di inizio riproduzione
Per iniziare il tracciamento di una sessione multimediale, chiama trackSessionStart sull’oggetto
media
.code language-none ADBMobile.media.trackSessionStart(mediaObject, customVideoMetadata);
note important IMPORTANT trackSessionStart
tiene traccia delle intenzioni di riproduzione dell’utente, non dell’inizio della riproduzione. Questa API viene utilizzata per caricare i dati/metadati video e per stimare la metrica QoS del tempo per l’avvio (la durata tratrackSessionStart
etrackPlay
).note note NOTE Il secondo valore corrisponde al nome dell’oggetto metadati video personalizzato creato nel passaggio 2. Se non utilizzi metadati video personalizzati, è sufficiente inviare un oggetto vuoto per l’argomento data
intrackSessionStart
, come mostrato nella riga commento nell’esempio di iOS precedente. -
Tracciare l’inizio effettivo della riproduzione
Identifica l’evento dal lettore video relativo all’inizio della riproduzione video, dove viene eseguito il rendering del primo fotogramma del video sullo schermo, e chiama trackPlay:
code language-none ADBMobile.media.trackPlay();
-
Aggiorna il valore della testina di riproduzione
Aggiorna il valore della posizione di
mediaUpdatePlayhead
più volte quando la testina di riproduzione si sposta.
Per il tracciamento dei video on-demand (VOD), il valore è specificato in secondi dall’inizio dell’elemento multimediale.
Per lo streaming live, se il lettore non fornisce informazioni sulla durata del contenuto, il valore può essere specificato come il numero di secondi trascorsi dalla mezzanotte UTC di quel giorno.code language-none ADBMobile().media.updatePlayhead(position)
note note NOTE Quando richiami il media.updatePlayhead
API:- Quando si utilizzano i marcatori di avanzamento, è necessario specificare la durata del contenuto e la testina di riproduzione deve essere aggiornata come numero di secondi dall’inizio dell’elemento multimediale, a partire da 0.
- Quando utilizzi gli SDK per contenuti multimediali, devi chiamare
media.updatePlayhead
API almeno una volta al secondo.
-
Tracciare il completamento della riproduzione
Identifica l’evento dal lettore video relativo al completamento della riproduzione video, in cui l’utente ha guardato il contenuto fino alla fine, e chiama trackComplete:
code language-none ADBMobile.media.trackComplete();
-
Tracciare la fine della sessione
Identifica l’evento dal lettore video relativo allo scaricamento/chiusura della riproduzione video, in cui l’utente chiude il video e/o il video viene completato e scaricato, e chiama trackSessionEnd:
code language-none ADBMobile.media.trackSessionEnd();
note important IMPORTANT trackSessionEnd
indica la fine di una sessione di tracciamento video. Se la sessione è stata vista correttamente fino al completamento, per cui l’utente ha guardato il contenuto fino alla fine, assicurati chetrackComplete
venga chiamato prima ditrackSessionEnd
. DopotrackSessionEnd
, qualsiasi chiamata APItrack*
viene ignorata, tranne che la chiamatatrackSessionStart
per una nuova sessione di tracciamento video. -
Tracciare tutti gli scenari di pausa possibili
Identifica l’evento dal lettore video relativo alla sospensione video e chiama trackPause:
code language-none ADBMobile.media.trackPause();
Scenari di sospensione
Identifica uno scenario in cui il lettore video si interrompe e verifica che
trackPause
sia chiamato correttamente. I seguenti scenari richiedono tutti una chiamatatrackPause()
dall’app:- L’utente mette esplicitamente in pausa l’app.
- Il lettore si mette in pausa da solo.
- (App per dispositivi mobili): l’utente mette l’applicazione in background, ma si desidera invece che l’app mantenga aperta la sessione.
- (App per dispositivi mobili): si verifica una qualsiasi interruzione del sistema causando l’esecuzione in background dell’applicazione. Ad esempio, l’utente riceve una chiamata oppure la notifica da un’altra applicazione, ma desideri che l’applicazione mantenga aperta la sessione per dare all’utente l’opportunità di riprendere il video dal punto in cui è stato interrotto.
-
Identifica l’evento dal lettore relativo alla riproduzione e/o la ripresa del video dalla sospensione e chiama trackPlay:
code language-none ADBMobile.media.trackPlay();
note tip TIP Potrebbe trattarsi della stessa origine evento utilizzata nel passaggio 4. Quando la riproduzione del video riprende, assicurati che ogni chiamata API trackPause()
sia associata alla seguente chiamata APItrackPlay()
.
- Scenari di tracciamento: riproduzione VOD senza annunci
- Lettore di esempio incluso nell’SDK di Chromecast per un esempio di tracciamento completo.