DokumentationAnalyticsGuide för direktuppspelande medietjänster

Fel

Senast uppdaterad: 29 maj 2026

Skapat för:

  • Developer

Felhändelsen signalerar att mediespelaren påträffade ett fel. Spåra ett fel stänger inte sessionen. Om felet förhindrar att uppspelningen fortsätter anropar du sessionsslutet efter felhändelsen.

Egenskapen errorDetails.source accepterar endast två värden: player (fel som kommer från mediespelaren) och external (fel från en extern källa som ett CDN eller nätverk).

Rekommenderade implementeringstyper

SDK för webben

Anropa sendEvent med eventType: "media.error" och det obligatoriska errorDetails:

code language-javascript 
alloy("sendEvent", {
  xdm: {
    eventType: "media.error",
    mediaCollection: {
      errorDetails: {
        name: "media-error-001",
        source: "player"
      },
      sessionID: "{sid}",
      playhead: 45
    }
  }
});
iOS

Anropa trackError med en fel-ID-sträng.

code language-swift 
tracker.trackError(errorId: "media-error-001")
Android

Anropa trackError med en fel-ID-sträng.

code language-kotlin 
tracker.trackError("media-error-001")
Roku

Ring sendMediaEvent med eventType: "media.error" och det obligatoriska errorDetails:

code language-brightscript 
m.aepSdk.sendMediaEvent({
    "xdm": {
        "eventType": "media.error",
        "mediaCollection": {
            "errorDetails": {
                "name": "media-error-001",
                "source": "player"
            },
            "playhead": 45
        }
    }
})
Media Edge API

Anropa slutpunkten error med den nödvändiga errorDetails:

code language-sh 
curl -X POST "https://edge.adobedc.net/ee/va/v1/error?configId={datastreamID}" \
--header 'Content-Type: application/json' \
--data '{
  "events": [{
    "xdm": {
      "eventType": "media.error",
      "mediaCollection": {
        "sessionID": "{sid}",
        "playhead": 45,
        "errorDetails": {
          "name": "media-error-001",
          "source": "player"
        }
      },
      "timestamp": "YYYY-08-20T22:41:40+00:00"
    }
  }]
}'

Äldre implementeringstyper (endast analys)

Media SDK JS 3.x

Anropa trackError med ett fel-ID-sträng:

code language-javascript 
tracker.trackError("media-error-001");
Chromecast

Anropa trackError med ett fel-ID-sträng:

code language-javascript 
ADBMobile.media.trackError("media-error-001");
Media Collection API

Skicka en error POST till händelsens slutpunkt:

code language-json 
{
  "playerTime": { "playhead": 45, "ts": 1699523820000 },
  "eventType": "error",
  "params": {
    "media.errorId": "media-error-001",
    "media.errorSource": "player"
  }
}
recommendation-more-help
media-analytics-help