DocumentationAnalyticsGuide des services des médias en streaming

Images perdues

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

Cette page traite de la collecte de données pour la variable Images perdues. Voir Images perdues pour la dimension et la mesure de reporting correspondantes.

style
shade-box

La variable images perdues correspond au nombre d’images perdues par le lecteur au cours de la session. Définissez-le sur l’objet QoE et mettez à jour la valeur à chaque fois que le lecteur signale de nouveaux abandons. Le serveur principal signale la dernière valeur à la fermeture de la session.

NOTE
Transmettez toujours le total cumulé d’images perdues pour l’ensemble de la session jusqu’à ce point, et non un delta par intervalle. Si vous réinitialisez la valeur sur 0 entre les mises à jour, le serveur principal reçoit la 0 comme valeur finale et signale aucune image perdue pour la session, quelle que soit ce qui a été effectivement perdu précédemment.
Propriété
Valeur
Variable de données contextuelles
a.media.qoe.droppedFrameCount
champ de collection XDM
xdm.mediaCollection.qoeDataDetails.droppedFrames
Caractéristique
c_contextdata.a.media.qoe.droppedFrameCount
Obligatoire
Non
Envoyé avec
Événements de qualité (changement de débit, début de la mémoire tampon, erreur), fermeture de la session

Types d’implémentation recommandés

SDK Web

droppedFrames à l’intérieur des xdm.mediaCollection.qoeDataDetails lors de l’appel de sendEvent :

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.bitrateChange",
    mediaCollection: {
      qoeDataDetails: {
        bitrate: 3200,
        droppedFrames: 3
      },
      sessionID: "{sid}",
      playhead: 90
    }
  }
});
iOS

Transmettez les images perdues comme quatrième argument à createQoEObject. Mettez à jour le dispositif de suivi avant le déclenchement d’un événement de qualité.

code language-swift 
let qoeObject = Media.createQoEObjectWith(bitrate: 3200,
                                       startupTime: 0,
                                               fps: 24,
                                     droppedFrames: 3)

tracker.updateQoEObject(qoe: qoeObject)
Android

Transmettez les images perdues comme quatrième argument à createQoEObject. Mettez à jour le dispositif de suivi avant le déclenchement d’un événement de qualité.

code language-kotlin 
val qoeObject = Media.createQoEObject(3200L,
                                      0.0,
                                      24.0,
                                      3L)

tracker.updateQoEObject(qoeObject)
Roku

droppedFrames à l’intérieur des xdm.mediaCollection.qoeDataDetails lors de l’appel de sendMediaEvent :

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.bitrateChange",
        "mediaCollection": {
            "qoeDataDetails": {
                "bitrate": 3200,
                "droppedFrames": 3
            },
            "playhead": 90
        }
    }
})
API Media Edge

Appelez le point d’entrée bitrateChange avec droppedFrames à l’intérieur du xdm.mediaCollection.qoeDataDetails :

code language-json 
{
  "events": [{
    "xdm": {
      "eventType": "media.bitrateChange",
      "mediaCollection": {
        "qoeDataDetails": {
          "droppedFrames": 3
        },
        "sessionID": "{sid}",
        "playhead": 90
      }
    }
  }]
}

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

Media SDK JS 3.x

Transmettez les images perdues comme quatrième argument à ADB.Media.createQoEObject :

code language-javascript 
var qoeObject = ADB.Media.createQoEObject(3200, 0, 24, 3);
tracker.updateQoEObject(qoeObject);
Chromecast

Transmettez le nombre cumulé d’images perdues comme quatrième argument pour ADBMobile.media.createQoSObject et mettre à jour le dispositif de suivi :

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate
  0,     // startupTime
  24,    // fps
  0      // droppedFrames (cumulative total)
);
ADBMobile.media.updateQoSObject(qosInfo);
API Media Collection

Incluez media.qoe.droppedFrames dans l’objet params :

code language-json 
{
  "playerTime": { "playhead": 90, "ts": 1699523820000 },
  "eventType": "bitrateChange",
  "params": {
    "media.qoe.droppedFrames": 3
  }
}

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