Fehlerreferenz für Wiedergabesitzungen

Lesen Sie die Problemantwort#

Zu den Playback-Session-Fehlern gehören HTTP Status plus maschinenlesbar code, requestId, retryable, und contractVersionValidierungsfehler erkennen auch Feldfehler. Anfrage aufzeichnen ID und gescheiterte Bühne ohne Protokollierung Zugangsdaten, DRM License Tokens, Challenges oder Lizenzbytes.

{
  "status": 400,
  "code": "playback_session_invalid",
  "title": "The playback session request is invalid.",
  "requestId": "your-request-correlation-id",
  "retryable": false,
  "contractVersion": 1
}

Tatsächliche Antworten können ein Problem type, detail und feldspezifisch errors enthalten.

playback_authentication_required#

HTTP 401. Der Client des Projekts API fehlt oder ist für diese Anforderung nicht gültig.

Überprüfen Sie den Server-Side Zugangsdaten, Environment und License-Tokens:create Scope.

playback_session_invalid#

HTTP 400. Ein oder mehrere Anforderungsfelder fehlschlagen.

Lesen Sie Fehler, beheben Sie die benannten Felder und passen Sie die Richtlinie dem veröffentlichten Paket an.

playback_environment_not_found#

HTTP 404. Die Wiedergabeumgebung konnte nicht gefunden werden.

Verwenden Sie die beabsichtigte Umgebung UUID mit ihrer eigenen Zugangsdaten.

playback_content_not_found#

HTTP 404. Kein veröffentlichtes Paket und aktiver Schlüsselsatz entsprechen dieser Anforderung.

Überprüfen Sie den vertrauenswürdigen Content ID, die Umgebung, den veröffentlichten Status und den aktiven Schlüsselsatz.

playback_manifest_not_found#

HTTP 404. Das erforderliche registrierte Manifest ist nicht verfügbar.

Stellen Sie sicher, dass die veröffentlichte Ausgabe den dafür erforderlichen Manifesttyp enthält DRM.

playback_blocked#

HTTP 403. Eine aktive DRM-X Blacklist-Regel blockiert die Wiedergabe.

Überprüfen Sie die anwendbare Zugriffsregel. Versuchen Sie es nicht erneut oder umgehen Sie es nicht von der Player.

concurrent_stream_limit_reached#

HTTP 403. Die Concurrent-Stream-Grenze wurde erreicht.

Veröffentlichen Sie abgeschlossene oder abgebrochene Sitzungen und wenden Sie Ihre Kontozugriffsrichtlinie an.

playback_session_rate_limited#

HTTP 429. Das Limit der Session-Endpunkt-Rate wurde erreicht.

Respect Retry-After, wenn vorgesehen. Vermeiden Sie doppelte Sitzungsanfragen und verwenden Sie ein begrenztes Backoff.

Getrennte API Fehler von Wiedergabefehlern#

Eine erfolgreiche Sitzung Antwort beweist nicht, dass Medien, Codecs, DRM Geräteunterstützung oder Ausgabeschutz sind bereit. Fehlerstufenmatrix um die erste gescheiterte Phase zu identifizieren.