DocumentazioneAnalyticsGuida ai servizi Streaming Media

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

Last update: Tue Jul 15 2025 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 precedente dell’SDK, puoi scaricare le Guide per sviluppatori qui: Scaricare gli SDK.

Implementare QOE

  1. Identifica quando il bitrate cambia durante la riproduzione del contenuto multimediale e crea l’istanza qoeObject tramite le informazioni QoE.

    Variabili dell’oggetto QoE:

    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
    Variabile Tipo Descrizione
    bitrate number Bitrate corrente
    startupTime number Tempo di avvio
    fps number Valore FPS
    droppedFrames number Numero di fotogrammi saltati

    Creazione di oggetti QoE:

    code language-js 
    // Replace <bitrate>, <startuptime>, <fps> and
// <droppeFrames> with the current playback QoE values.
var qoeObject = ADB.Media.createQoEObject(<bitrate>,
                                               <startuptime>,
                                               <fps>,
                                               <droppedFrames>);
tracker.updateQoEObject(qoeObject);

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

    code language-js 
    _onBitrateChange = function() {
    // If the new bitrate value is available provide it to the tracker.
    var qoeObject = ADB.Media.createQoEObject(1000000, 2.4, 25, 10);
    tracker.updateQoEObject(qoeObject);

    tracker.trackEvent(ADB.Media.Event.BitrateChange);
};
    note important
    IMPORTANT
    Aggiorna l’oggetto QoE e chiama l’evento di modifica del bitrate su ogni modifica del bitrate. Questo fornisce i dati QoE più precisi.

  3. Assicurati di chiamare il metodo updateQoEObject() per fornire all’SDK le informazioni QoE 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