Tracciare la riproduzione di base in JavaScript 2.x track-core-playback-on-javascript

Le istruzioni seguenti forniscono indicazioni per l’implementazione negli SDK 2.x.

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.

    API createMediaObject

    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center 23-align-center
    Nome variabile Descrizione Obbligatorio
    name Nome file multimediale
    mediaid Identificatore univoco del file multimediale
    length Lunghezza del file multimediale
    streamType Tipo di flusso (vedi Costanti StreamType sotto)
    mediaType Tipo di file multimediale (vedi Costanti MediaType sotto)

    Costanti StreamType:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Nome costante Descrizione
    VOD Tipo di flusso per Video on Demand.
    LIVE Tipo di flusso per il contenuto LIVE.
    LINEAR Tipo di flusso per contenuti LINEAR.
    AOD Tipo di flusso per audio on-demand.
    AUDIOBOOK Tipo di flusso per audiolibro.
    PODCAST Tipo di flusso per podcast.

    Costanti MediaType:

    table 0-row-2 1-row-2 2-row-2
    Nome costante Descrizione
    Audio Tipo di file multimediale per flussi Audio.
    Video Tipo di file multimediale per i flussi Video.
    code language-none
    var mediaObject =
      MediaHeartbeat.createMediaObject(<MEDIA_NAME>,
                                      <MEDIA_ID,
                                      <MEDIA_LENGTH>,
                                      MediaHeartbeat.StreamType.VOD,
                                      <MEDIA_TYPE>);
    
  2. Allega metadati

    Facoltativamente, allega oggetti metadati standard e/o personalizzati alla sessione di tracciamento tramite variabili di dati di contesto.

    • Metadati standard

      Implementazione dei metadati standard in JavaScript

      note note
      NOTE
      Il collegamento dell’oggetto metadati standard all’oggetto multimediale è facoltativo.
    • Metadati personalizzati

      Crea un oggetto variabile per le variabili personalizzate e compila i dati per questo elemento multimediale. 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 a tracciare una sessione multimediale, effettua una chiamata trackSessionStart sull’istanza Media Heartbeat:

    code language-js
    mediaHeartbeat.trackSessionStart(mediaObject, customVideoMetadata);
    
    note tip
    TIP
    Il secondo valore è il nome dell’oggetto metadati multimediali personalizzati creato al passaggio 2.
    note important
    IMPORTANT
    trackSessionStart tiene traccia delle intenzioni di riproduzione dell’utente, non dell’inizio della riproduzione. Questa API viene utilizzata per caricare dati/metadati e per stimare la metrica QoS relativa al tempo di avvio (durata tra trackSessionStart e trackPlay).
    note note
    NOTE
    Se non utilizzi metadati personalizzati, invia semplicemente un oggetto vuoto per l’argomento data in trackSessionStart, come mostrato nella riga esterna di commento nell’esempio di iOS precedente.
  4. Tracciare l’inizio effettivo della riproduzione

    Identifica l’evento dal lettore multimediale per l’inizio della riproduzione, dove viene eseguito il rendering del primo fotogramma del file multimediale sullo schermo ed effettua una chiamata trackPlay.

    code language-js
    mediaHeartbeat.trackPlay();
    
  5. Tracciare il completamento della riproduzione

    Identifica l’evento dal lettore multimediale per il completamento della riproduzione in cui l’utente ha guardato il contenuto fino alla fine ed effettua una chiamata trackComplete.

    code language-js
    mediaHeartbeat.trackComplete();
    
  6. Tracciare la fine della sessione

    Identifica l’evento dal lettore multimediale per lo scaricamento/la chiusura della riproduzione in cui l’utente chiude l’elemento multimediale e/o l’elemento multimediale viene completato e scaricato ed effettua una chiamata trackSessionEnd.

    code language-js
    mediaHeartbeat.trackSessionEnd();
    
    note important
    IMPORTANT
    trackSessionEnd indica la fine di una sessione di tracciamento. Se la sessione è stata guardata correttamente fino al completamento, dove 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 la chiamata trackSessionStart per una nuova sessione di tracciamento video.
  7. Tracciare tutti gli scenari di pausa possibili

    Identifica l’evento dal lettore multimediale per la pausa ed effettua una chiamata trackPause.

    code language-js
    mediaHeartbeat.trackPause();
    

    Scenari di pausa

    Identifica uno scenario in cui il lettore multimediale 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) - Può verificarsi qualsiasi tipo di interruzione di sistema che porta l’applicazione in background. 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 l’elemento multimediale dal punto in cui è stato interrotto.
  8. Identifica l’evento dal lettore per la riproduzione e/o la ripresa dalla pausa ed effettua una chiamata trackPlay:

    code language-js
    mediaHeartbeat.trackPlay();
    
    note tip
    TIP
    Potrebbe trattarsi della stessa origine evento utilizzata nel passaggio 4. Quando la riproduzione riprende, assicurati che ogni chiamata API trackPause() sia associata alla seguente chiamata API trackPlay().
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb