DocumentatieAnalyticsHandleiding voor streaming-mediaservices

Wijziging van bitsnelheid

Laatst bijgewerkt: 29 mei 2026

Gemaakt voor:

  • Developer

De gebeurtenis die de bitsnelheid wijzigt, geeft aan dat de speler een nieuwe bitsnelheid voor afspelen heeft onderhandeld. Verzend deze wanneer de bitsnelheid verandert tijdens het afspelen. Neem de nieuwe bitsnelheidwaarde op in de QoE-gegevens, zodat de backend Average bitrate en de per-bitrate-emmerdimensie kan berekenen.

Aanbevolen implementatietypen

SDK van het Web

Roep sendEvent ​ aan met eventType: "media.bitrateChange" en de nieuwe bitsnelheid in 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

Maak een object QoE met de nieuwe bitsnelheid en werk de tracker bij voordat de gebeurtenis voor de wijziging van de bitsnelheid wordt geactiveerd.

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

Maak een object QoE met de nieuwe bitsnelheid en werk de tracker bij voordat de gebeurtenis voor de wijziging van de bitsnelheid wordt geactiveerd.

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

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

Roep sendMediaEvent aan met eventType: "media.bitrateChange" en de nieuwe bitsnelheid in qoeDataDetails :

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

Roep het ​ bitrateChange ​ eindpunt met nieuwe bitrate in 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"
    }
  }]
}'

Oudere implementatietypen (alleen voor analyse)

Media SDK JS 3.x

Maak een object QoE met de nieuwe bitsnelheid en werk de tracker bij:

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

Werk het object QoS bij dat door de gedelegeerde getQoSObject wordt geretourneerd en volg vervolgens de gebeurtenis:

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);
de Inzameling API van Media

Verzend a bitrateChange POST naar het ​ gebeurteniseindpunt ​ met nieuwe bitrate in qoeData:

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