DocumentationAnalyticsGuide des services des médias en streaming

Débit binaire

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable Bitrate. Voir Débit moyen (dimension) et Débit moyen (mesure) pour les variables de rapports correspondantes.

style
shade-box

La variable de débit est le débit de lecture actuel, en kilobits par seconde. Définissez-le sur l’objet QoE chaque fois que le lecteur négocie un débit, puis mettez à jour l’objet QoE lorsque le débit change. Le serveur principal utilise des valeurs de débit pour calculer la mesure Débit moyen, la dimension par débit-intervalle et la mesure Modifications du débit.

Propriété
Valeur
Variable de données contextuelles
a.media.qoe.bitrateAverageBucket
champ de collection XDM
xdm.mediaCollection.qoeDataDetails.bitrate
Caractéristique
c_contextdata.a.media.qoe.bitrateAverageBucket
Obligatoire
Non
Envoyé avec
Événements de qualité (changement de débit, début de la mémoire tampon, erreur), fermeture de la session

Types d’implémentation recommandés

SDK Web

Définissez des bitrate internes xdm.mediaCollection.qoeDataDetails sur media.bitrateChange (ou tout événement lié à la qualité) lors de l’appel de sendEvent :

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.bitrateChange",
    mediaCollection: {
      qoeDataDetails: {
        bitrate: 3200,
        droppedFrames: 0,
        framesPerSecond: 24,
        timeToStart: 0
      },
      sessionID: "{sid}",
      playhead: 90
    }
  }
});
iOS

Transmettez le débit binaire comme premier argument à createQoEObject. Mettez à jour l’objet QoE sur le dispositif de suivi avant le déclenchement d’un événement de qualité.

code language-swift 
let qoeObject = Media.createQoEObjectWith(bitrate: 3200,
                                       startupTime: 0,
                                               fps: 24,
                                     droppedFrames: 0)

tracker.updateQoEObject(qoe: qoeObject)
Android

Transmettez le débit binaire comme premier argument à createQoEObject. Mettez à jour l’objet QoE sur le dispositif de suivi avant le déclenchement d’un événement de qualité.

code language-kotlin 
val qoeObject = Media.createQoEObject(3200L,
                                      0.0,
                                      24.0,
                                      0L)

tracker.updateQoEObject(qoeObject)
Roku

Définissez des bitrate à l’intérieur des xdm.mediaCollection.qoeDataDetails lors de l’appel de sendMediaEvent pour des événements de qualité tels que media.bitrateChange :

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.bitrateChange",
        "mediaCollection": {
            "qoeDataDetails": {
                "bitrate": 3200,
                "droppedFrames": 0,
                "framesPerSecond": 24,
                "timeToStart": 0
            },
            "playhead": 90
        }
    }
})
API Media Edge

Appelez le point d’entrée bitrateChange avec bitrate à l’intérieur du xdm.mediaCollection.qoeDataDetails :

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.bitrateChange",
      "mediaCollection": {
        "qoeDataDetails": {
          "bitrate": 3200
        },
        "sessionID": "{sid}",
        "playhead": 90
      }
    }
  }]
}

Types d’implémentation hérités (Analytics uniquement)

Media SDK JS 3.x

Transmettez le débit comme premier argument pour ADB.Media.createQoEObject et mettre à jour le dispositif de suivi :

code language-javascript 
var qoeObject = ADB.Media.createQoEObject(
  3200,  // bitrate (kbps)
  0,     // startup time (ms)
  24,    // fps
  0      // dropped frames
);

tracker.updateQoEObject(qoeObject);
Chromecast

Transmettez le débit en kbit/s comme premier argument pour ADBMobile.media.createQoSObject et mettre à jour le dispositif de suivi :

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate (kbps)
  0,     // startupTime
  24,    // fps
  0      // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
API Media Collection

Incluez media.qoe.bitrate dans l’objet params de votre bitrateChange requête POST :

code language-json 
{
  "playerTime": { "playhead": 90, "ts": 1699523820000 },
  "eventType": "bitrateChange",
  "params": {
    "media.qoe.bitrate": 3200
  }
}

Consultez la référence des événements de l’API Media Collection pour obtenir la structure complète des requêtes.

recommendation-more-help
media-analytics-help