DocumentatieAnalyticsHandleiding voor streaming-mediaservices

Framestart

Laatst bijgewerkt: 29 mei 2026

Gemaakt voor:

  • Developer

De statusstartgebeurtenis geeft aan dat de mediaspeler een bijgehouden status heeft ingevoerd, zoals volledig scherm, dempen of ondertiteling sluiten. Een speler kan in meerdere frames tegelijk zijn en frames kunnen in dezelfde gebeurtenisaanroep worden gestart en beëindigd. Sluit elke staat met het eind van de a ​ Staat ​ gebeurtenis.

Geldige statusnamen: fullscreen, mute, closedCaptioning, pictureInPicture, inFocus

Aanbevolen implementatietypen

SDK van het Web

Roep sendEvent ​ aan met eventType: "media.statesUpdate" en de naam van de staat in statesStart :

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

De veelvoudige staten kunnen in de zelfde vraag worden begonnen:

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

Gebruik trackPlayerStateStart met een frameobject dat is gemaakt op basis van de juiste MediaConstants.PlayerState -constante.

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

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

Gebruik trackPlayerStateStart met een frameobject dat is gemaakt op basis van de juiste MediaConstants.PlayerState -constante.

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

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

Roep sendMediaEvent aan met eventType: "media.statesUpdate" en de naam van de staat in statesStart :

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

Roep het ​ statesUpdate ​ eindpunt met de staatsnaam in statesStart:

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"
    }
  }]
}'

Oudere implementatietypen (alleen voor analyse)

Media SDK JS 3.x

Gebruik ADB.Media.createStateObject met de juiste ADB.Media.PlayerState -constante:

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

tracker.trackPlayerStateStart(stateObject);
Chromecast

Gebruik ADBMobile.media.createStateObject met de juiste ADBMobile.media.PlayerState -constante:

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

ADBMobile.media.trackEvent(ADBMobile.media.Event.StateStart, stateObject);
de Inzameling API van Media

Verzend a stateStart POST naar het ​ gebeurteniseindpunt ​:

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