DocumentationAnalyticsGuide des services des médias en streaming

Erreur

Dernière mise à jour : 29 mai 2026

Créé pour :

  • Developer

L’événement d’erreur indique que le lecteur multimédia a rencontré une erreur. Le suivi d’une erreur ne ferme pas la session. Si l’erreur empêche la lecture de continuer, appelez Fin de session après l’événement d’erreur.

La propriété errorDetails.source accepte uniquement deux valeurs : player (erreurs provenant du lecteur multimédia) et external (erreurs provenant d’une source externe telle qu’un réseau de diffusion de contenu ou un réseau).

Types d’implémentation recommandés

SDK Web

Appelez sendEvent avec les eventType: "media.error" et les errorDetails requises :

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

Appelez trackError avec une chaîne d’ID d’erreur.

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

Appelez trackError avec une chaîne d’ID d’erreur.

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

Appelez sendMediaEvent avec les eventType: "media.error" et les errorDetails requises :

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

Appelez le point d’entrée error avec la errorDetails requise :

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"
    }
  }]
}'

Types d’implémentation hérités (Analytics uniquement)

Media SDK JS 3.x

Appelez trackError avec une chaîne d’ID d’erreur :

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

Appelez trackError avec une chaîne d’ID d’erreur :

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

Envoyez une error POST au point d’entrée événements :

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