DokumentationAnalyticsHandbuch zu Streaming-Mediendiensten

Frames pro Sekunde

Letzte Aktualisierung: 29. Mai 2026

Erstellt für:

  • Developer

Die Variable „Frames pro Sekunde“ ist die aktuelle Framerate des Streams. Legen Sie sie auf dem QoE-Objekt neben Bitrate und Dropped Frames fest, damit das Backend für jede Wiedergabesitzung Kontext in voller Qualität hat. Adobe Analytics erstellt nicht automatisch eine Berichtsvariable für die Framerate. Erstellen Sie eine benutzerdefinierte Verarbeitungsregel, wenn sie als Bericht angezeigt werden soll.

Eigenschaft
Wert
Kontextdatenvariable
Keine (Adobe Analytics weist keinen reservierten Kontextdatenschlüssel für die Framerate zu)
XDM-Sammlungsfeld
xdm.mediaCollection.qoeDataDetails.framesPerSecond
Audience Manager-Eigenschaft
nicht angegeben
Erforderlich
Nein
Gesendet mit
Qualitätsereignisse (Bitratenänderung, Pufferstart, Fehler), Sitzungsschluss

Empfohlene Implementierungsarten

Web SDK

framesPerSecond in xdm.mediaCollection.qoeDataDetails festlegen, wenn sendEvent aufgerufen wird:

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

Übergeben Sie die Framerate als drittes Argument (fps) an createQoEObject.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Übergeben Sie die Framerate als drittes Argument (fps) an createQoEObject.

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

tracker.updateQoEObject(qoeObject)
Roku Edge

framesPerSecond in xdm.mediaCollection.qoeDataDetails festlegen, wenn sendMediaEvent aufgerufen wird:

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

Rufen Sie den bitrateChange-Endpunkt mit framesPerSecond in xdm.mediaCollection.qoeDataDetails auf:

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

Legacy-Implementierungstypen (nur Analytics)

Media SDK JS 3.x

Übergeben Sie die Framerate als drittes Argument für ADB.Media.createQoEObject:

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

Übergeben Sie die Framerate als drittes Argument (fps), um den Tracker zu ADBMobile.media.createQoSObject und zu aktualisieren:

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate
  0,     // startupTime
  24,    // fps
  0      // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
Roku 2.x

Übergeben Sie die Framerate als drittes Argument (fps), um den Tracker mit mediaUpdateQoS zu adb_media_init_qosinfo und zu aktualisieren:

code language-brightscript 
adb = ADBMobile()
qosInfo = adb_media_init_qosinfo(3200.0, 0.0, 24.0, 0.0)  ' bitrate, startupTime, fps, droppedFrames

adb.mediaUpdateQoS(qosInfo)
Media Collection API

media.qoe.framesPerSecond in das params einschließen:

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

Die vollständige Anfragestruktur ​ Sie in der ​ zur Mediensammlungs-API-Ereignisreferenz .

recommendation-more-help
media-analytics-help