DocumentationAnalyticsGuide de collection des médias en streaming

Effectuer le suivi de la qualité de l’expérience à l’aide de JavaScript 2.x track-quality-of-experience-on-javascript

Last update: Wed Jun 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice
  • Administration
  • Développeur

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

IMPORTANT
Si vous mettez en œuvre une version 1.x du kit SDK, vous pouvez télécharger les Guides du développeur 1.x dans la rubrique Téléchargement des SDK.

Mise en oeuvre de QOS

  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 :

    note tip
    TIP
    Ces variables ne sont nécessaires que si vous envisagez de suivre 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
    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 de l’objet QoS :

    code language-js 
    // Replace <bitrate>, <startuptime>, <fps> and
// <droppeFrames> with the current playback QoS values.
var qosObject = MediaHeartbeat.createQoSObject(<bitrate>,
                                               <startuptime>,
                                               <fps>,
                                               <droppedFrames>);

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

    code language-js 
    _onBitrateChange = function() {
    this._mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};
    note important
    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.)

    note tip
    TIP
    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().
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb