Panoramica overview

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.

Il monitoraggio della qualità dell’esperienza include la qualità del servizio (QoS) e il tracciamento degli errori, entrambi elementi opzionali e non obbligatori per le implementazioni di tracciamento dei contenuti multimediali di base. Puoi utilizzare l’API del lettore multimediale per identificare le variabili relative ai QoS e al tracciamento degli errori. Di seguito sono riportati gli elementi chiave per il tracciamento della qualità dell’esperienza:

Eventi del lettore player-events

Su qualsiasi modifica della metrica QoS:

Crea o aggiorna l’istanza dell’oggetto QoS per la riproduzione. Riferimento API QoS

Su tutti gli eventi di modifica del bitrate

Chiamata trackEvent(Media.Heartbeat.Event.BitrateChange);

Implementare QOS

  1. Identifica quando una qualsiasi delle metriche QoS cambia durante la riproduzione di contenuti multimediali, crea MediaObject utilizzando le informazioni QoS e aggiornando queste ultime con i nuovi dati.

    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
    startupTime Tempo di avvio
    fps Valore FPS
    droppedFrames Numero di fotogrammi saltati
  2. Assicurati che il metodo getQoSObject() restituisca le informazioni QoS più aggiornate.

  3. Quando la riproduzione commuta i bitrate, esegui la chiamata BitrateChange nell’istanza Media Heartbeat.

    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.

Il codice di esempio seguente utilizza l’SDK JavaScript 2.x per un lettore multimediale HTML5. Usa questo codice con il codice di riproduzione del contenuto multimediale principale.

var mediaDelegate = new MediaHeartbeatDelegate();
...

// This is called periodically by MediaHeartbeat instance
mediaDelegate.prototype.getQoSObject = function() {
    return this.qosInfo;
};

if (e.type == "qos_update") {
    var qosInfo = MediaHeartbeat.createQoSObject(<BITRATE>,<STARTUP_TIME>,<FPS>,<DROPPED_FRAMES>);
    mediaDelegate.qosInfo = qosInfo;
};

if (e.type == "bitrate_change") {
    this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb