DocumentaciónAnalyticsGuía de servicios de medios de streaming

Fotogramas perdidos

Última actualización: 29 de mayo de 2026

Creado para:

  • Developer

Esta página cubre la recopilación de datos para la variable Marcos perdidos. Vea Fotogramas perdidos para la dimensión y métrica de informes correspondiente.

style
shade-box

La variable de fotogramas perdidos es el número de fotogramas que el reproductor ha perdido durante la sesión. Configúrelo en el objeto QoE y actualice el valor cada vez que el reproductor notifique nuevas caídas. El servidor informa del valor más reciente al cierre de la sesión.

NOTE
Pasar siempre el total acumulado de fotogramas perdidos para toda la sesión hasta ese momento, no un delta por intervalo. Si restablece el valor a 0 entre actualizaciones, el servidor recibe 0 como valor final e informa de cero fotogramas perdidos para la sesión, independientemente de lo que se haya perdido anteriormente.
Propiedad
Valor
Variable de datos de contexto
a.media.qoe.droppedFrameCount
Campo de colección XDM
xdm.mediaCollection.qoeDataDetails.droppedFrames
rasgo de Audience Manager
c_contextdata.a.media.qoe.droppedFrameCount
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 droppedFrames dentro de xdm.mediaCollection.qoeDataDetails al llamar a sendEvent:

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

Pase los fotogramas perdidos como el cuarto argumento a createQoEObject. Actualice el rastreador antes de que se active cualquier evento de calidad.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Pase los fotogramas perdidos como el cuarto argumento a createQoEObject. Actualice el rastreador antes de que se active cualquier evento de calidad.

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

tracker.updateQoEObject(qoeObject)
Roku

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

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

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

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

Tipos de implementación heredados (solo Analytics)

Media SDK JS 3.x

Pasar fotogramas perdidos como el cuarto argumento a ADB.Media.createQoEObject:

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

Pase el recuento acumulado de fotogramas perdidos como el cuarto argumento a ADBMobile.media.createQoSObject y actualice el rastreador:

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

Incluir media.qoe.droppedFrames en el objeto params:

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

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

recommendation-more-help
media-analytics-help