Le istruzioni seguenti forniscono indicazioni per l’implementazione con tutti gli SDK 2.x.
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. Per identificare le variabili relative a QoS e al tracciamento degli errori, è possibile utilizzare l’API del lettore multimediale.
qosObject
trackEvent(Media.Heartbeat.Event.BitrateChange, qosObject);
Effettua la chiamata trackError("media error id");
Identifica quando il bitrate cambia durante la riproduzione del contenuto multimediale e crea l’istanza MediaObject
utilizzando le informazioni QoS.
Variabili QoSObject:
Queste variabili sono necessarie solo se intendi tenere traccia di QoS.
Variabile | Descrizione | Obbligatorio |
---|---|---|
bitrate |
Bitrate corrente | Sì |
startupTime |
Tempo di avvio | Sì |
fps |
Valore FPS | Sì |
droppedFrames |
Numero di fotogrammi saltati | Sì |
Creazione dell’oggetto QoS: createQoSObject
qosInfo = ADBMobile.media.createQoSObject(50000, 0, 24, 10);
Quando la riproduzione commuta i bitrate, esegui la chiamata di evento BitrateChange
nell’istanza Media Heartbeat: trackEvent
ADBMobile.media.trackEvent(ADBMobile.media.Event.BitrateChange);
Aggiorna l’oggetto QoS e chiama l’evento di modifica del bitrate su ogni modifica del bitrate. Questo fornisce i dati QoS più precisi.
Assicurati che il metodo getQoSObject()
restituisca le informazioni QoS più aggiornate.
Quando il lettore multimediale rileva un errore e l‘evento di errore è disponibile per l’API del lettore, utilizza trackError()
per acquisire le informazioni sull’errore. (Consulta Panoramica.)
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()
.