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

Quadros por segundo

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

Criado para:

  • Developer

A variável frames por segundo é a taxa de quadros atual do fluxo. Defina-o no objeto de QoE ao lado da taxa de bits e dos quadros soltos, para que o back-end tenha um contexto de qualidade total para cada sessão de reprodução. O Adobe Analytics não cria automaticamente uma variável de relatório para a taxa de quadros; crie uma regra de processamento personalizada se desejar que ela apareça como um relatório.

Propriedade
Valor
Variável de dados de contexto
Nenhum (o Adobe Analytics não atribui uma chave de dados de contexto reservada para a taxa de quadros)
Campo da coleção XDM
xdm.mediaCollection.qoeDataDetails.framesPerSecond
Característica do Audience Manager
N/D
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 framesPerSecond dentro de xdm.mediaCollection.qoeDataDetails ao chamar sendEvent:

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

Transmita a taxa de quadros como o terceiro argumento (fps) para createQoEObject.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Transmita a taxa de quadros como o terceiro argumento (fps) para createQoEObject.

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

tracker.updateQoEObject(qoeObject)
Roku

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

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

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

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

Tipos de implementação herdada (somente Analytics)

Media SDK JS 3.x

Transmita a taxa de quadros como o terceiro argumento para ADB.Media.createQoEObject:

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

Transmita a taxa de quadros como o terceiro argumento (fps) para ADBMobile.media.createQoSObject e atualize o rastreador:

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

Incluir media.qoe.framesPerSecond no objeto params:

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

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

recommendation-more-help
media-analytics-help