Suivre la qualité de l’expérience sur Chromecast

Les instructions suivantes fournissent des conseils pour la mise en œuvre sur tous les kits SDK 2.x.

Aperçu

La qualité du suivi de l’expérience inclut la qualité du service (QoS) et le suivi des erreurs, ces deux éléments étant facultatifs et n’étant pas obligatoires pour les mises en œuvre de suivi multimédia principal. Vous pouvez utiliser l’API du lecteur multimédia pour identifier les variables liées à QoS et au suivi des erreurs.

Événements du lecteur

À chaque événement de changement de débit binaire

• Créez/mettez à jour l’instance d’objet QoS pour la lecture, qosObject
• Appel trackEvent(Media.Heartbeat.Event.BitrateChange, qosObject);

Lors des erreurs du lecteur

L’appel trackError("media error id");

Mise en œuvre

1. Identifiez le moment où le débit binaire change pendant la lecture multimédia et créez l’instance MediaObject à l’aide des informations QoS.

   Variables QoSObject :

   CONSEIL

   Ces variables ne sont nécessaires que si vous envisagez de suivre QoS.

   Variable	Description	Obligatoire
   bitrate	Débit actuel	Oui
   startupTime	Temps de démarrage	Oui
   fps	Valeur fps	Oui
   droppedFrames	Nombre de pertes d’images	Oui

   Création d’objet QoS : createQoSObject

   qosInfo = ADBMobile.media.createQoSObject(50000, 0, 24, 10);
   

2. Lorsque la lecture change de débit binaire, appelez l’événement BitrateChange dans l’instance Media Heartbeat : trackEvent

   ADBMobile.media.trackEvent(ADBMobile.media.Event.BitrateChange);
   

   IMPORTANT

   Mettez à jour l’objet QoS et appelez l’événement de changement de débit binaire à chaque changement de débit binaire. Ceci produit les données QoS les plus précises.

3. Assurez-vous que la méthode getQoSObject() renvoie les informations QoS les plus récentes.

4. Lorsque le lecteur multimédia rencontre une erreur et que l’événement d’erreur est disponible pour l’API du lecteur, utilisez l’événement trackError() pour capturer les informations d’erreur. (Voir Aperçu.)

   CONSEIL

   Le suivi des erreurs du lecteur multimédia n’arrête pas la session de suivi multimédia. Si l’erreur du lecteur multimédia empêche la lecture de se poursuivre, veillez à ce que la session de suivi multimédia soit fermée en appelant trackSessionEnd() après avoir appelé trackError().