DocumentationAnalyticsGuide des services des médias en streaming

Images par seconde

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

La variable images par seconde est la fréquence d’images actuelle du flux. Définissez-le sur l’objet QoE à côté du débit et des images perdues afin que le serveur principal dispose d’un contexte de qualité complète pour chaque session de lecture. Adobe Analytics ne crée pas automatiquement de variable de création de rapports pour la fréquence d’image ; créez une règle de traitement personnalisée si vous souhaitez qu’elle apparaisse sous la forme d’un rapport.

Propriété
Valeur
Variable de données contextuelles
Aucune (Adobe Analytics n’attribue pas de clé de données contextuelles réservée pour la fréquence d’image)
champ de collection XDM
xdm.mediaCollection.qoeDataDetails.framesPerSecond
Caractéristique
S.O.
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

framesPerSecond à 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,
        framesPerSecond: 24
      },
      sessionID: "{sid}",
      playhead: 90
    }
  }
});
iOS

Transmettez la fréquence d’image comme troisième argument (fps) à createQoEObject.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Transmettez la fréquence d’image comme troisième argument (fps) à createQoEObject.

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

tracker.updateQoEObject(qoeObject)
Roku

framesPerSecond à 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,
                "framesPerSecond": 24
            },
            "playhead": 90
        }
    }
})
API Media Edge

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

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

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

Media SDK JS 3.x

Transmettez la fréquence d’image comme troisième argument à ADB.Media.createQoEObject :

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

Transmettez la fréquence d’image comme troisième argument (fps) 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
);
ADBMobile.media.updateQoSObject(qosInfo);
API Media Collection

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

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

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