DocumentaciónAnalyticsGuía de servicios de medios de streaming

Fotogramas por segundo

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

La variable fotogramas por segundo es la velocidad de fotogramas actual del flujo. Configúrelo en el objeto QoE junto con la velocidad de bits y los fotogramas perdidos para que el back-end tenga un contexto de calidad total para cada sesión de reproducción. Adobe Analytics no crea automáticamente una variable de informe de velocidad de fotogramas; cree una regla de procesamiento personalizada si desea que aparezca como un informe.

Propiedad
Valor
Variable de datos de contexto
Ninguno (Adobe Analytics no asigna una clave de datos de contexto reservada para la velocidad de fotogramas)
Campo de colección XDM
xdm.mediaCollection.qoeDataDetails.framesPerSecond
rasgo de Audience Manager
N/A
Requerido
No
Enviado con
Eventos de calidad (cambio de velocidad de bits, inicio del búfer, error), cierre de sesión

Tipos de implementación recomendados

SDK web

Establecer framesPerSecond dentro de xdm.mediaCollection.qoeDataDetails al llamar a sendEvent:

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

Pase la velocidad de fotogramas como tercer argumento (fps) a createQoEObject.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Pase la velocidad de fotogramas como tercer argumento (fps) a createQoEObject.

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

tracker.updateQoEObject(qoeObject)
Roku

Establecer framesPerSecond dentro de xdm.mediaCollection.qoeDataDetails al llamar a sendMediaEvent:

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

Llame al extremo bitrateChange con framesPerSecond dentro de xdm.mediaCollection.qoeDataDetails:

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

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pase la velocidad de fotogramas como tercer argumento a ADB.Media.createQoEObject:

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

Pase la velocidad de fotogramas como tercer argumento (fps) a ADBMobile.media.createQoSObject y actualice el rastreador:

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate
  0,     // startupTime
  24,    // fps
  0      // droppedFrames
);
ADBMobile.media.updateQoSObject(qosInfo);
API de recopilación de medios

Incluir media.qoe.framesPerSecond en el objeto params:

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

Consulte la referencia de eventos de API de Media Collection para obtener la estructura de solicitudes completa.

recommendation-more-help
media-analytics-help