DocumentationAnalyticsGuide des services des médias en streaming

Mode muet

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour l’état du lecteur Muet. Voir Flux impactés par le mode muet, Nombre de messages muets et Durée totale du mode muet pour les mesures de rapports correspondantes.

style
shade-box

Le statut Silence du lecteur indique quand la visionneuse désactive le son. Déclenchez un événement de début d’état lorsque la visionneuse désactive le son et un événement de fin d’état lorsque la visionneuse le réactive. 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.mute.set, a.media.states.mute.count, a.media.states.mute.time
champ de collection XDM
xdm.mediaCollection.statesStart[] et xdm.mediaCollection.statesEnd[] (entrées avec name: "mute")
caractéristiques
c_contextdata.a.media.states.mute.set, c_contextdata.a.media.states.mute.count, c_contextdata.a.media.states.mute.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: "mute" }],
      sessionID: "{sid}",
      playhead: 60
    }
  }
});

Lorsque la visionneuse réactive le son, 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: "mute" }],
      sessionID: "{sid}",
      playhead: 90
    }
  }
});
iOS

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

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

tracker.trackPlayerStateStart(info: stateObject)
tracker.trackPlayerStateEnd(info: stateObject)
Android

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

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

tracker.trackPlayerStateStart(stateObject)
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": "mute" }],
            "playhead": 60
        }
    }
})

Lorsque la visionneuse réactive le son, 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": "mute" }],
            "playhead": 90
        }
    }
})
API Media Edge

Appelez le point d’entrée statesUpdate avec le mute en statesStart (ou statesEnd lorsque la visionneuse active le son) :

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.statesUpdate",
      "mediaCollection": {
        "statesStart": [{ "name": "mute" }],
        "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.Mute :

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

tracker.trackPlayerStateStart(stateObject);
tracker.trackPlayerStateEnd(stateObject);
Chromecast

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

code language-javascript 
var stateObject = ADBMobile.media.createStateObject("mute");
ADBMobile.media.trackEvent(ADBMobile.media.Event.StateStart, stateObject);
// When the viewer unmutes:
ADBMobile.media.trackEvent(ADBMobile.media.Event.StateEnd, stateObject);
API Media Collection

Envoyez une requête POST stateStart lorsque la visionneuse désactive le son, et une requête POST stateEnd lorsqu’elle le fait :

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

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