DocumentazioneAnalyticsGuida alla raccolta di contenuti multimediali in streaming

Tracciare la qualità dell’esperienza utilizzando JavaScript 2.x track-quality-of-experience-on-javascript

Last update: Wed Jun 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Utente
  • Amministratore
  • Sviluppatore

Le istruzioni seguenti forniscono indicazioni per l’implementazione con tutti gli SDK 2.x.

IMPORTANT
Se implementi una versione 1.x dell’SDK, puoi scaricare le guide per sviluppatori 1.x qui: Scarica SDK.

Implementare QOS

  1. Identificare quando il bitrate cambia durante la riproduzione del contenuto multimediale e creare l’istanza MediaObject utilizzando le informazioni QoS.

    Variabili QoSObject:

    note tip
    TIP
    Queste variabili sono necessarie solo se intendi tenere traccia di QoS.
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    Variabile Descrizione Obbligatorio
    bitrate Bitrate corrente Sì
    startupTime Tempo di avvio Sì
    fps Valore FPS Sì
    droppedFrames Numero di fotogrammi saltati Sì

    Creazione di oggetti QoS:

    code language-js 
    // Replace <bitrate>, <startuptime>, <fps> and
// <droppeFrames> with the current playback QoS values.
var qosObject = MediaHeartbeat.createQoSObject(<bitrate>,
                                               <startuptime>,
                                               <fps>,
                                               <droppedFrames>);

  2. Quando la riproduzione commuta i bitrate, esegui la chiamata di evento BitrateChange nell’istanza Media Heartbeat:

    code language-js 
    _onBitrateChange = function() {
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};
    note important
    IMPORTANT
    Aggiorna l’oggetto QoS e chiama l’evento di modifica del bitrate su ogni modifica del bitrate. Questo fornisce i dati QoS più precisi.

  3. Assicurati che il metodo getQoSObject() restituisca le informazioni QoS più aggiornate.

  4. Quando il lettore multimediale rileva un errore e l’evento di errore è disponibile per l’API del lettore, utilizza trackError() per acquisire informazioni sull’errore. (Consulta Panoramica.)

    note tip
    TIP
    Il tracciamento degli errori del lettore multimediale non interrompe la sessione di tracciamento dei contenuti. Se l’errore del lettore multimediale impedisce il proseguimento della riproduzione, assicurati che la sessione di tracciamento dei contenuti multimediali sia chiusa con una chiamata trackSessionEnd() dopo la chiamata trackError().
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb