DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Zustandsstart

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Das Status-Startereignis signalisiert, dass der Medien-Player in einen verfolgten Status wie Vollbild, Stummschaltung oder Untertitel übergegangen ist. Ein Player kann sich gleichzeitig in mehreren Status befinden und Status können im selben Ereignisaufruf gestartet und beendet werden. Schließen Sie jeden Status mit einem State End-Ereignis.

Gültige Statusnamen: fullscreen, mute, closedCaptioning, pictureInPicture, inFocus

Empfohlene Implementierungsarten

Web SDK

Rufen Sie sendEvent mit eventType: "media.statesUpdate" und dem Statusnamen in statesStart auf:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.statesUpdate",
    mediaCollection: {
      statesStart: [{ name: "fullscreen" }],
      sessionID: "{sid}",
      playhead: 60
    }
  }
});

Im selben Aufruf können mehrere Status gestartet werden:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.statesUpdate",
    mediaCollection: {
      statesStart: [
        { name: "fullscreen" },
        { name: "mute" }
      ],
      sessionID: "{sid}",
      playhead: 60
    }
  }
});
iOS

Verwenden Sie trackPlayerStateStart mit einem Statusobjekt, das aus der entsprechenden MediaConstants.PlayerState erstellt wurde.

code language-swift 
let stateObject = Media.createStateObjectWith(stateName: MediaConstants.PlayerState.FULLSCREEN)

tracker.trackEvent(event: MediaEvent.StateStart, info: stateObject, metadata: nil)
Android

Verwenden Sie trackPlayerStateStart mit einem Statusobjekt, das aus der entsprechenden MediaConstants.PlayerState erstellt wurde.

code language-kotlin 
val stateObject = Media.createStateObject(MediaConstants.PlayerState.FULLSCREEN)

tracker.trackEvent(Media.Event.StateStart, stateObject, null)
Roku

Rufen Sie sendMediaEvent mit eventType: "media.statesUpdate" und dem Statusnamen in statesStart auf:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.statesUpdate",
        "mediaCollection": {
            "statesStart": [{ "name": "fullscreen" }],
            "playhead": 60
        }
    }
})
Media Edge-API

Rufen Sie den statesUpdate-Endpunkt mit dem Statusnamen in statesStart auf:

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

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Verwenden Sie ADB.Media.createStateObject mit der entsprechenden ADB.Media.PlayerState:

code language-javascript 
var stateObject = ADB.Media.createStateObject(ADB.Media.PlayerState.Fullscreen);

tracker.trackPlayerStateStart(stateObject);
Chromecast

Verwenden Sie ADBMobile.media.createStateObject mit der entsprechenden ADBMobile.media.PlayerState:

code language-javascript 
var stateObject = ADBMobile.media.createStateObject(ADBMobile.media.PlayerState.FullScreen);

ADBMobile.media.trackEvent(ADBMobile.media.Event.StateStart, stateObject);
Media Collection API

Senden Sie einen stateStart POST an den events-Endpunkt:

code language-json 
{
  "playerTime": { "playhead": 60, "ts": 1699523820000 },
  "eventType": "stateStart",
  "params": {
    "media.state.name": "fullscreen"
  }
}
recommendation-more-help
media-analytics-help