DocumentationAnalyticsGuide des services des médias en streaming

Plein écran

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page couvre la collecte de données pour l’état du lecteur Plein écran. Voir Flux affectés par le plein écran, Nombre de plein écran et Durée totale du plein écran pour les mesures de rapports correspondantes.

style
shade-box

L’état du lecteur plein écran effectue le suivi lorsque la visionneuse entre en lecture plein écran et la quitte. Déclenchez un événement de début d’état lorsque la visionneuse passe en mode plein écran et un événement de fin d’état lorsque la visionneuse se ferme. Le serveur principal calcule trois mesures à partir de ces événements : les flux impactés, le nombre d’entrées d’état et la durée totale d’état.

Propriété
Valeur
Variables de données contextuelles
a.media.states.fullscreen.set, a.media.states.fullscreen.count, a.media.states.fullscreen.time
champ de collection XDM
xdm.mediaCollection.statesStart[] et xdm.mediaCollection.statesEnd[] (entrées avec name: "fullscreen")
caractéristiques
c_contextdata.a.media.states.fullscreen.set, c_contextdata.a.media.states.fullscreen.count, c_contextdata.a.media.states.fullscreen.time
Obligatoire
Non
Envoyé avec
Début de l’état, fin de l’état

Types d’implémentation recommandés

SDK Web

Utilisez sendEvent pour envoyer un événement media.statesUpdate avec l’état ajouté à statesStart :

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

Lorsque la visionneuse quitte le mode plein écran, envoyez un autre événement dont le statut est défini sur statesEnd :

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

Utilisez tracker.trackPlayerStateStart() et tracker.trackPlayerStateEnd() avec la constante MediaConstants.PlayerState.FULLSCREEN .

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

tracker.trackPlayerStateStart(info: stateObject)
// ...later, when the user exits full-screen:
tracker.trackPlayerStateEnd(info: stateObject)
Android

Utilisez tracker.trackPlayerStateStart() et tracker.trackPlayerStateEnd() avec la constante MediaConstants.PlayerState.FULLSCREEN .

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

tracker.trackPlayerStateStart(stateObject)
// ...later, when the user exits full-screen:
tracker.trackPlayerStateEnd(stateObject)
Roku

Utilisez sendMediaEvent pour envoyer un événement media.statesUpdate avec l’état ajouté à statesStart :

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

Lorsque la visionneuse quitte le mode plein écran, envoyez un autre événement dont le statut est défini sur statesEnd :

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

Appelez le point d’entrée statesUpdate avec le fullscreen en statesStart (ou statesEnd lorsque la visionneuse se ferme) :

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.statesUpdate",
      "mediaCollection": {
        "statesStart": [{ "name": "fullscreen" }],
        "sessionID": "{sid}",
        "playhead": 60
      }
    }
  }]
}

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

Media SDK JS 3.x

Utilisez ADB.Media.createStateObject et la constante ADB.Media.PlayerState.FullScreen :

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

tracker.trackPlayerStateStart(stateObject);
// ...later, when the user exits full-screen:
tracker.trackPlayerStateEnd(stateObject);
Chromecast

Utilisez ADBMobile.media.createStateObject avec la chaîne "fullscreen" directement, car Chromecast ne dispose pas de constantes PlayerState nommées :

code language-javascript 
var stateObject = ADBMobile.media.createStateObject("fullscreen");
ADBMobile.media.trackEvent(ADBMobile.media.Event.StateStart, stateObject);
// When the user exits full-screen:
ADBMobile.media.trackEvent(ADBMobile.media.Event.StateEnd, stateObject);
API Media Collection

Envoyez une requête POST stateStart lorsque la visionneuse passe en mode plein écran et une requête POST stateEnd lorsqu’elle se ferme :

code language-json 
{
  "playerTime": { "playhead": 60, "ts": 1699523820000 },
  "eventType": "stateStart",
  "params": {
    "media.state.name": "fullscreen"
  }
}
code language-json 
{
  "playerTime": { "playhead": 90, "ts": 1699523850000 },
  "eventType": "stateEnd",
  "params": {
    "media.state.name": "fullscreen"
  }
}

Consultez la référence des événements de l’API Media Collection pour obtenir la structure complète des requêtes.

recommendation-more-help
media-analytics-help