Tracciare la riproduzione di base in Chromecast track-core-playback-on-chromecast

Questa documentazione tratta il tracciamento nella versione 2.x dell’SDK.

IMPORTANT
Se stai implementando una versione 1.x di SDK, puoi scaricare le guide per sviluppatori 1.x qui: Scarica SDK
  1. 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:

    createMediaObject

    code language-none
    mediaObject = ADBMobile.media.createMediaObject(<name>, <id>, <duration>, <streamType>, <mediaType>);
    

    Costanti StreamType:

    Media di ADBMobile

    Costanti MediaType:

    Media di ADBMobile

  2. 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"
      };
      
  3. 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 tra trackSessionStart e trackPlay).
    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 in trackSessionStart, come mostrato nella riga commento nell’esempio di iOS precedente.
  4. 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();
    
  5. 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.
  6. 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();
    
  7. 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 che trackComplete venga chiamato prima di trackSessionEnd. Dopo trackSessionEnd, qualsiasi chiamata API track* viene ignorata, tranne che la chiamata trackSessionStart per una nuova sessione di tracciamento video.
  8. 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 chiamata trackPause() 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.
  9. 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 API trackPlay().
  • Scenari di tracciamento: riproduzione VOD senza annunci
  • Lettore di esempio incluso nell’SDK di Chromecast per un esempio di tracciamento completo.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb