DocumentationAnalyticsGuide des services des médias en streaming

Changement de débit

Dernière mise à jour : 24 septembre 2026

Créé pour :

  • Developer

L’événement de changement de débit indique que le lecteur a négocié un nouveau débit de lecture. Envoyez-le chaque fois que le débit change pendant la lecture. Incluez la nouvelle valeur de débit dans les données de la QoE afin que le serveur principal puisse calculer débit moyen et la dimension par débit-intervalle.

Types d’implémentation recommandés

SDK Web

Appelez sendEvent avec eventType: "media.bitrateChange" et le nouveau débit en qoeDataDetails :

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

Créez un objet QoE avec le nouveau débit et mettez à jour le dispositif de suivi avant le déclenchement de l’événement de changement de débit.

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

tracker.updateQoEObject(qoe: qoeObject)
tracker.trackEvent(event: MediaEvent.BitrateChange, info: nil, metadata: nil)
Android

Créez un objet QoE avec le nouveau débit et mettez à jour le dispositif de suivi avant le déclenchement de l’événement de changement de débit.

code language-kotlin 
val qoeObject = Media.createQoEObject(3200, 0, 24, 0)

tracker.updateQoEObject(qoeObject)
tracker.trackEvent(Media.Event.BitrateChange, null, null)
Roku Edge

Appelez sendMediaEvent avec eventType: "media.bitrateChange" et le nouveau débit en qoeDataDetails :

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 le nouveau débit en qoeDataDetails :

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/bitrateChange?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.bitrateChange",
      "mediaCollection": {
        "qoeDataDetails": {
          "bitrate": 3200
        },
        "sessionID": "{sid}",
        "playhead": 90
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

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

Media SDK JS 3.x

Créez un objet QoE avec le nouveau débit et mettez à 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);
tracker.trackEvent(ADB.Media.Event.BitrateChange);
Chromecast

Mettez à jour l’objet QoS renvoyé par le délégué getQoSObject, puis suivez l’événement :

code language-javascript 
// Update QoS data via the delegate
this._qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate (kbps)
  0,     // dropped frames
  24,    // fps
  0      // startup time
);

ADBMobile.media.trackEvent(ADBMobile.media.Event.BitrateChange);
Roku 2.x

Créez un objet QoS avec le nouveau débit binaire à l’aide de adb_media_init_qosinfo, mettez à jour le dispositif de suivi avec mediaUpdateQoS, puis suivez l’événement. Notez l’ordre des paramètres Roku : bitrate, startupTime, fps, droppedFrames.

code language-brightscript 
adb = ADBMobile()
qosInfo = adb_media_init_qosinfo(3200.0, 0.0, 24.0, 0.0)  ' bitrate, startupTime, fps, droppedFrames

adb.mediaUpdateQoS(qosInfo)
adb.mediaTrackEvent(adb.MEDIA_BITRATE_CHANGE)
API Media Collection

Envoyez une bitrateChange POST au point d’entrée événements avec le nouveau débit en qoeData :

code language-json 
{
  "playerTime": { "playhead": 90, "ts": 1699523820000 },
  "eventType": "bitrateChange",
  "qoeData": {
    "media.qoe.bitrate": 3200
  }
}
recommendation-more-help
media-analytics-help