DocumentaçãoAnalyticsGuia de serviços para mídia de streaming

Quadros soltos

Última atualização: 29 de maio de 2026

Criado para:

  • Developer

Esta página aborda a coleção de dados da variável Quadros soltos. Consulte Quadros soltos para obter a dimensão e a métrica de relatório correspondentes.

style
shade-box

A variável dropped frames é a contagem de quadros que o reprodutor derrubou durante a sessão. Defina-o no objeto de QoE e atualize o valor sempre que o reprodutor relatar novas quedas. O backend relata o valor mais recente no fechamento da sessão.

NOTE
Sempre passe o total cumulativo de quadros ignorados para toda a sessão até esse ponto, não um delta por intervalo. Se você redefinir o valor para 0 entre as atualizações, o back-end receberá 0 como o valor final e relatará zero quadros ignorados para a sessão, independentemente do que foi ignorado anteriormente.
Propriedade
Valor
Variável de dados de contexto
a.media.qoe.droppedFrameCount
Campo da coleção XDM
xdm.mediaCollection.qoeDataDetails.droppedFrames
Característica do Audience Manager
c_contextdata.a.media.qoe.droppedFrameCount
Obrigatório
Não
Enviado com
Eventos de qualidade (alteração na taxa de bits, início do buffer, erro), fechamento da sessão

Tipos de implementação recomendados

Web SDK

Definir droppedFrames dentro de xdm.mediaCollection.qoeDataDetails ao chamar sendEvent:

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

Passar quadros ignorados como quarto argumento para createQoEObject. Atualize o rastreador antes de qualquer evento de qualidade ser acionado.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Passar quadros ignorados como quarto argumento para createQoEObject. Atualize o rastreador antes de qualquer evento de qualidade ser acionado.

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

tracker.updateQoEObject(qoeObject)
Roku

Definir droppedFrames dentro de xdm.mediaCollection.qoeDataDetails ao chamar sendMediaEvent:

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

Chame o ponto de extremidade bitrateChange com droppedFrames dentro de xdm.mediaCollection.qoeDataDetails:

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

Tipos de implementação herdada (somente Analytics)

Media SDK JS 3.x

Passar quadros ignorados como quarto argumento para ADB.Media.createQoEObject:

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

Passe a contagem cumulativa de quadros ignorados como o quarto argumento para ADBMobile.media.createQoSObject e atualize o rastreador:

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate
  0,     // startupTime
  24,    // fps
  0      // droppedFrames (cumulative total)
);
ADBMobile.media.updateQoSObject(qosInfo);
API da coleção de mídia

Incluir media.qoe.droppedFrames no objeto params:

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

Consulte a Referência de eventos da API Media Collection para obter a estrutura de solicitação completa.

recommendation-more-help
media-analytics-help