DocumentazioneAnalyticsGuida ai servizi Streaming Media

Fotogrammi persi

Ultimo aggiornamento: 29 maggio 2026

Creato per:

  • Developer

In questa pagina viene illustrata la raccolta dati per la variabile Dropped frames. Vedi Fotogrammi saltati per la dimensione e la metrica di reporting corrispondenti.

style
shade-box

La variabile dei fotogrammi saltati è il conteggio corrente dei fotogrammi saltati dal lettore durante la sessione. Impostalo sull’oggetto QoE e aggiorna il valore ogni volta che il lettore segnala nuove cadute. Il backend riporta il valore più recente alla chiusura della sessione.

NOTE
Passa sempre il totale cumulativo dei fotogrammi saltati per l'intera sessione fino a quel punto, non un delta per intervallo. Se si reimposta il valore su 0 tra gli aggiornamenti, il backend riceve 0 come valore finale e segnala zero fotogrammi saltati per la sessione indipendentemente da ciò che è stato effettivamente saltato in precedenza.
Proprietà
Valore
Variabile di dati di contesto
a.media.qoe.droppedFrameCount
Campo raccolta XDM
xdm.mediaCollection.qoeDataDetails.droppedFrames
Caratteristica Audience Manager
c_contextdata.a.media.qoe.droppedFrameCount
Obbligatorio
No
Inviato con
Eventi di qualità (modifica bitrate, avvio buffer, errore), chiusura sessione

Tipi di implementazione consigliati

Web SDK

Imposta droppedFrames all’interno di xdm.mediaCollection.qoeDataDetails quando chiama sendEvent:

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

Passa i fotogrammi saltati come quarto argomento a createQoEObject. Aggiorna il tracciatore prima che venga attivato qualsiasi evento di qualità.

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

tracker.updateQoEObject(qoe: qoeObject)
Android

Passa i fotogrammi saltati come quarto argomento a createQoEObject. Aggiorna il tracciatore prima che venga attivato qualsiasi evento di qualità.

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

tracker.updateQoEObject(qoeObject)
Roku

Imposta droppedFrames in xdm.mediaCollection.qoeDataDetails quando chiama sendMediaEvent:

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

Chiama l’endpoint bitrateChange con droppedFrames all’interno di xdm.mediaCollection.qoeDataDetails:

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

Tipi di implementazione legacy (solo Analytics)

Media SDK JS 3.x

Passa i fotogrammi saltati come quarto argomento a ADB.Media.createQoEObject:

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

Passa il conteggio cumulativo dei fotogrammi saltati come quarto argomento a ADBMobile.media.createQoSObject e aggiorna il tracciatore:

code language-javascript 
var qosInfo = ADBMobile.media.createQoSObject(
  3200,  // bitrate
  0,     // startupTime
  24,    // fps
  0      // droppedFrames (cumulative total)
);
ADBMobile.media.updateQoSObject(qosInfo);
API Media Collection

Includi media.qoe.droppedFrames nell’oggetto params:

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

Per la struttura completa delle richieste, consulta il Riferimento eventi API di Media Collection.

recommendation-more-help
media-analytics-help