Début de l’état
L’événement de début d’état indique que le lecteur multimédia est entré dans un état suivi, tel que plein écran, muet ou sous-titrage. Un lecteur peut se trouver dans plusieurs états simultanément, et les états peuvent être démarrés et terminés dans le même appel d’événement. Fermez chaque état avec un événement State end.
Noms d’état valides : fullscreen, mute, closedCaptioning, pictureInPicture, inFocus
- Conditions préalables : début de session
- Mesure associée : varie en fonction de l’état. Voir Suivi de l’état du lecteur
SDK web
Appelez sendEvent avec eventType: "media.statesUpdate" et le nom de l’état en statesStart :
alloy("sendEvent", {
xdm: {
eventType: "media.statesUpdate",
mediaCollection: {
statesStart: [{ name: "fullscreen" }],
sessionID: "{sid}",
playhead: 60
}
}
});
Plusieurs états peuvent être démarrés dans le même appel :
alloy("sendEvent", {
xdm: {
eventType: "media.statesUpdate",
mediaCollection: {
statesStart: [
{ name: "fullscreen" },
{ name: "mute" }
],
sessionID: "{sid}",
playhead: 60
}
}
});
SDK mobile
Utilisez trackPlayerStateStart avec un objet d’état créé à partir de la constante de MediaConstants.PlayerState appropriée.
iOS (Swift)
let stateObject = Media.createStateObjectWith(stateName: MediaConstants.PlayerState.FULLSCREEN)
tracker.trackEvent(event: MediaEvent.StateStart, info: stateObject, metadata: nil)
Android (Kotlin)
val stateObject = Media.createStateObject(MediaConstants.PlayerState.FULLSCREEN)
tracker.trackEvent(Media.Event.StateStart, stateObject, null)
Roku (BrightScript)
Appelez sendMediaEvent avec eventType: "media.statesUpdate" et le nom de l’état en statesStart :
m.aepSdk.sendMediaEvent({
"xdm": {
"eventType": "media.statesUpdate",
"mediaCollection": {
"statesStart": [{ "name": "fullscreen" }],
"playhead": 60
}
}
})
API Media Edge
Appelez le point d’entrée statesUpdate avec le nom d’état en statesStart :
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"
}
}]
}'
SDK Media
Utilisez ADB.Media.createStateObject avec la constante de ADB.Media.PlayerState appropriée :
var stateObject = ADB.Media.createStateObject(ADB.Media.PlayerState.Fullscreen);
tracker.trackPlayerStateStart(stateObject);
API Media Collection
Envoyez une stateStart POST au point d’entrée événements :
{
"playerTime": { "playhead": 60, "ts": 1699523820000 },
"eventType": "stateStart",
"params": {
"media.state.name": "fullscreen"
}
}