Panoramica

Il monitoraggio della qualità dell’esperienza include la qualità del servizio (QoS) e il monitoraggio degli errori, entrambi elementi facoltativi e non sono richiesti per le implementazioni di tracciamento dei supporti di base. Potete utilizzare l’API Media Player per identificare le variabili relative ai QoS e al tracciamento degli errori. Gli elementi chiave per il monitoraggio della qualità dell’esperienza sono i seguenti:

Eventi del lettore

In caso di modifiche della metrica QoS:

Creare o aggiornare 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);

Implementazione di QOS

1. Identificare il momento in cui una qualsiasi delle metriche QOS cambia durante la riproduzione multimediale, creare l’ MediaObject oggetto utilizzando le informazioni QoS e aggiornare le nuove informazioni QoS.

   Variabili QoSObject:

   SUGGERIMENTO

   Queste variabili sono necessarie solo se si prevede di tenere traccia dei QoS.

   Variabile	Descrizione	Obbligatorio
   bitrate	Bitrate corrente	Sì
   startupTime	Tempo di avvio	Sì
   fps	Valore FPS	Sì
   droppedFrames	Numero di fotogrammi saltati	Sì

2. Accertatevi che getQoSObject() il metodo restituisca le informazioni QoS più aggiornate.

3. Quando la riproduzione cambia bitrate, chiamate l’ BitrateChange evento nell’istanza Media Heartbeat.

   IMPORTANTE

   Aggiornare l’oggetto QoS e richiamare 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. Utilizzare questo codice con il codice di riproduzione del contenuto multimediale di base.

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); 
};