Mitteilungen zur Medienwiedergabe

Google Cast-Absenderanwendungen steuern die Wiedergabe auf dem Empfängergerät, indem sie Nachrichten im JSON-Format an die Empfängeranwendung senden. Ebenso sendet der Empfänger Nachrichten an den Absender zurück, ebenfalls im JSON-Format. Die Nachrichten können Befehle des Absenders sein, die den Playerstatus ändern, Antworten des Empfängers auf diese Befehle oder Datenstrukturen, die die Media für die Empfängeranwendung beschreiben.

Gemäß den zusätzlichen Nutzungsbedingungen für Entwickler des Google Cast SDK muss eine Cast-Media-Anwendung diese hier definierten Nachrichten verwenden, um die Medienwiedergabe auf dem Empfänger zu steuern. Dadurch wird der Media-App eine einheitliche Nutzererfahrung auf allen Plattformen geboten und sichergestellt, dass eine Cast-Anwendung neue und zukünftige Anwendungsfälle unterstützt. Diese Strukturen unterstützen bei Bedarf auch benutzerdefinierte Daten. Eine Anwendung kann eigene Meldungen für Befehle definieren, die vom SDK nicht unterstützt werden.

Der Namespace für die Nachrichten zur Medienwiedergabe ist urn:x-cast:com.google.cast.media.

Hinweis:Die Nachrichten und Strukturen in dieser Spezifikation haben eine implizite maximale Größe, die durch die maximale Größe einer Transportnachricht bestimmt wird. Für einzelne Felder gibt es kein Limit. Die maximale Größe für Transportnachrichten beträgt derzeit 64 KB.

Gängige Datenstrukturen für Namespaces

Eine Obermenge der Datenstrukturen, die von allen Artefakten des Media-Namespace verwendet werden, ist in einem gemeinsamen Namespace definiert.

Bild

Dies ist die Beschreibung eines Bildes, einschließlich einer geringen Menge an Metadaten, damit die Senderanwendung je nach Rendering-Methode eine Auswahl an Bildern hat.

Höhe und Breite sind nur für ein Element in einem Array von Bildern optional. Wenn beispielsweise nur ein Element zurückgegeben wird, ist es optional. Wenn zwei Elemente zurückgegeben werden, muss für eines eine Höhe und Breite angegeben werden. Der Absender kann jedoch die Option „default“ (Standard) auswählen, wenn ihm das Element mit den spezifischen Parametern nicht gefällt.

Name	Typ	Beschreibung
url	URI	URI für das Bild
height	integer	optional Höhe des Bildes
width	integer	optional Breite des Bilds

Lautstärke

Die Lautstärke des Media-Streams. Wird für Ein- und Ausblendeffekte im Media-Stream verwendet. Hinweis: Die Systemlautstärke wird über die Sender-APIs geändert. Die Stream-Lautstärke darf nicht in Verbindung mit dem Lautstärkeregler oder den Lautstärketasten verwendet werden, um die Gerätelautstärke zu regeln. Mindestens einer der folgenden Parameter muss übergeben werden, um die Streamlautstärke zu ändern.

Name	Typ	Beschreibung
Ebene	double	optional Aktuelle Lautstärke des Streams als Wert zwischen 0,0 und 1,0, wobei 1,0 die maximale Lautstärke ist.
stummgeschaltet	boolean	optional Gibt an, ob das Cast-Gerät unabhängig von der Lautstärke stummgeschaltet ist.

Datenstrukturen für Media-Namespaces

Diese Nachrichten beschreiben den Status des Media Players. Der Namespace ist urn:x-cast:com.google.cast.media.

MediaInformation

Diese Datenstruktur beschreibt einen Media-Stream.

Name	Typ	Beschreibung
contentId	String	Dienstspezifische Kennung des Inhalts, der derzeit vom Media-Player geladen wird. Dies ist ein Freiformstring und anwendungsspezifisch. In den meisten Fällen ist das die URL zu den Media, der Absender kann aber auch einen String übergeben, den der Empfänger richtig interpretieren kann. Maximale Länge: 1.000 Zeichen
streamType	enum (string)	Beschreibt den Typ des Media-Artefakts als eine der folgenden Optionen: NONE BUFFERED LIVE
contentType	String	MIME-Inhaltstyp der wiedergegebenen Medien
metadata	Objekt	optional Das Media-Metadatenobjekt, eines der folgenden: 0  GenericMediaMetadata 1  MovieMediaMetadata 2  TvShowMediaMetadata 3  MusicTrackMediaMetadata 4  PhotoMediaMetadata
duration	double	optional Dauer des aktuell wiedergegebenen Streams in Sekunden
customData	Objekt	optional Anwendungsspezifisches Daten-Blob, das entweder von der Senderanwendung oder der Empfängeranwendung definiert wird

GenericMediaMetadata

Beschreibt ein generisches Media-Artefakt.

Name	Typ	Beschreibung
metadataType	integer	0  (einziger Wert)
title	String	optional Aussagekräftiger Titel des Inhalts. Der Player kann den Titel unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
Untertitel	String	optional Beschreibender Untertitel des Inhalts. Der Player kann den Titel unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
Bilder	Image[]	optional Array von URLs zu einem Bild, das mit dem Inhalt verknüpft ist. Der Ausgangswert des Felds kann vom Absender in der Load-Nachricht angegeben werden. Empfohlene Größen angeben
releaseDate	String (ISO 8601)	optional Datum und Uhrzeit der Veröffentlichung dieses Inhalts im ISO 8601-Format. Der Player kann den Titel unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.

MovieMediaMetadata

Beschreibt ein Film-Media-Artefakt.

Name	Typ	Beschreibung
metadataType	integer	1  (einziger Wert)
title	String	optional Aussagekräftiger Titel des Inhalts. Der Player kann den Titel unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
Untertitel	String	optional Beschreibender Untertitel des Inhalts. Der Player kann den Titel unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
Studio	String	optional Studio, das die Inhalte veröffentlicht hat. Der Player kann das Studio unabhängig über die content_id abrufen oder es kann vom Absender in der Load-Nachricht angegeben werden.
Bilder	Image[]	optional Array von URLs zu einem Bild, das mit dem Inhalt verknüpft ist. Der Ausgangswert des Felds kann vom Absender in der Load-Nachricht angegeben werden. Empfohlene Größen angeben
releaseDate	String (ISO 8601)	optional Datum und Uhrzeit der Veröffentlichung dieses Inhalts im ISO 8601-Format. Der Player kann den Titel unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.

TvShowMediaMetadata

Beschreibt ein Media-Artefakt für eine Folge einer TV-Sendung.

Name	Typ	Beschreibung
metadataType	integer	2  (einziger Wert)
seriesTitle	String	optional Aussagekräftiger Titel der Fernsehserie. Der Player kann den Titel unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
Untertitel	String	optional Beschreibender Untertitel der TV-Folge. Der Player kann den Titel unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
season	integer	optional Staffelnummer der Serie
Folge	integer	optional Folgennummer (in der Staffel) der Serie
Bilder	Image[]	optional Array von URLs zu einem Bild, das mit dem Inhalt verknüpft ist. Der Ausgangswert des Felds kann vom Absender in der Load-Nachricht angegeben werden. Empfohlene Größen angeben
originalAirDate	String (ISO 8601)	optional Datum und Uhrzeit der Veröffentlichung dieser Folge im ISO 8601-Format. Der Player kann „originalAirDate“ unabhängig über „content_id“ abrufen oder der Sender kann es in der Load-Nachricht angeben.

MusicTrackMediaMetadata

Beschreibt ein Musiktrack-Media-Artefakt.

Name	Typ	Beschreibung
metadataType	integer	3  (einziger Wert)
albumName	String	optional Album oder Sammlung, aus der dieser Titel stammt. Der Player kann den AlbumName unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
title	String	optional Name des Tracks (z. B. Songtitel). Der Player kann den Titel unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
albumArtist	String	optional Name des Künstlers, der mit dem Album verknüpft ist, auf dem sich dieser Titel befindet. Der Player kann „albumArtist“ unabhängig über „content_id“ abrufen oder der Absender kann es in der Load-Nachricht angeben.
Künstler	String	optional Name des Künstlers, der mit dem Mediatrack verknüpft ist. Der Player kann den Künstler unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
composer	String	optional Name des Komponisten, der mit dem Mediatrack verknüpft ist. Der Player kann den Komponisten unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
trackNumber	integer	optional Nummer des Titels auf dem Album
discNumber	integer	optional Nummer des Volumes (z. B. einer Disc) des Albums
Bilder	Image[]	optional Array von URLs zu einem Bild, das mit dem Inhalt verknüpft ist. Der Ausgangswert des Felds kann vom Absender in der Load-Nachricht angegeben werden. Empfohlene Größen angeben
releaseDate	String (ISO 8601)	optional Datum und Uhrzeit der Veröffentlichung dieses Inhalts im ISO 8601-Format. Der Player kann „releaseDate“ unabhängig über „content_id“ abrufen oder der Absender kann es in der Load-Nachricht angeben.

PhotoMediaMetadata

Beschreibt ein fotografisches Media-Artefakt.

Name	Typ	Beschreibung
metadataType	integer	4  (einziger Wert)
title	String	optional Titel des Fotos. Der Player kann den Titel unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
Künstler	String	optional Name des Fotografen. Der Player kann den Künstler unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
den Standort	String	optional Mündliche Angabe des Orts, an dem das Foto aufgenommen wurde, z. B. „Madrid, Spanien“. Der Player kann den Standort unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
latitude	double	optional Breitengrad des Ortes, an dem das Foto aufgenommen wurde. Der Player kann den Breitengrad unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
longitude	double	optional Wert für den geografischen Längengrad des Ortes, an dem das Foto aufgenommen wurde. Der Spieler kann den Längengrad unabhängig über die content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden.
width	integer	optional Breite des Fotos in Pixeln. Der Player kann die Breite unabhängig über die content_id abrufen oder sie kann vom Absender in der Load-Nachricht angegeben werden.
height	integer	optional Höhe des Fotos in Pixeln. Der Player kann die Höhe unabhängig über die content_id abrufen oder sie kann vom Absender in der Load-Nachricht angegeben werden.
creationDateTime	String (ISO 8601)	optional ISO 8601-Datum und ‑Uhrzeit, zu der dieses Foto aufgenommen wurde. Der Player kann „creationDateTime“ unabhängig über „content_id“ abrufen oder der Sender kann es in der Load-Nachricht angeben.

MediaStatus

Beschreibt den aktuellen Status des Media-Artefakts in Bezug auf die Sitzung.

Name	Typ	Beschreibung
mediaSessionId	integer	Eindeutige ID für die Wiedergabe dieser bestimmten Sitzung. Diese ID wird vom Empfänger bei LOAD festgelegt und kann verwendet werden, um eine bestimmte Instanz einer Wiedergabe zu identifizieren. Beispiel: Zwei Wiedergaben von „Wish You Were Here“ in derselben Sitzung haben jeweils eine eindeutige mediaSessionId.
media	MediaInformation	optional (für Statusmeldungen) Vollständige Beschreibung der wiedergegebenen Inhalte. Wird nur in Statusmeldungen zurückgegeben, wenn sich die MediaInformation geändert hat.
playbackRate	float	Gibt an, ob die Media-Zeit fortschreitet und mit welcher Rate. Dies ist unabhängig vom Player-Status, da die Media-Zeit in jedem Status angehalten werden kann. 1,0 entspricht der normalen Geschwindigkeit, 0,5 der Zeitlupe.
playerState	enum (String)	Beschreibt den Status des Players als eine der folgenden Optionen: IDLE  Player wurde noch nicht geladen WIEDERGABE  Der Player gibt gerade Inhalte wieder. BUFFERING  Der Player befindet sich im PLAY-Modus, gibt aber keine Inhalte wieder (currentTime ändert sich nicht). PAUSED  Player is paused
idleReason	enum (String)	optional Wenn „playerState“ IDLE ist und der Grund dafür bekannt ist, wird diese Property angegeben. Wenn sich der Player im Status „IDLE“ befindet, weil er gerade gestartet wurde, wird diese Eigenschaft nicht angegeben. Wenn sich der Player in einem anderen Status befindet, sollte diese Eigenschaft nicht angegeben werden. Es gelten die folgenden Werte: CANCELLED  Ein Absender hat die Wiedergabe mit dem Befehl STOP beendet. UNTERBROCHEN  Ein Absender hat mit dem Befehl „LOAD“ die Wiedergabe anderer Medien angefordert. FINISHED  Die Medienwiedergabe wurde abgeschlossen. FEHLER  Die Medienwiedergabe wurde aufgrund eines Fehlers unterbrochen, z. B. wenn der Player die Medien aufgrund von Netzwerkproblemen nicht herunterladen konnte.
currentTime	double	Die aktuelle Position des Media Players seit Beginn des Inhalts in Sekunden. Wenn es sich um Livestream-Inhalte handelt, gibt dieses Feld die Zeit in Sekunden ab Beginn des Ereignisses an, die dem Zuschauer bekannt sein sollte.
supportedMediaCommands	flags	Flags, die beschreiben, welche Media-Befehle der Media-Player unterstützt: 1 << 0  Pause 1 << 1  Suchen 1 << 2  Streamvolumen 1 << 3  Stream stummschalten 1 << 4  Vorspulen (eingestellt) 1 << 5  Zurückspulen (verworfen) 1 << 6  Queue next 1 << 7  Queue previous (Vorherige in die Warteschlange einreihen) 1 << 8  Queue shuffle 1 << 9  Werbung überspringen 1 << 10  Wiedergabeliste „Alle wiederholen“ 1 << 11  Wiederholung eines Titels in der Warteschlange 1 << 12  Tracks bearbeiten 1 << 13  Wiedergabegeschwindigkeit 1 << 14  „Gefällt mir“-Angabe 1 << 15  „Mag ich nicht“-Bewertung 1 << 16  Folgen 1 << 17  Nicht mehr folgen Kombinationen werden als Summen beschrieben, z. B. „Pause+Seek+StreamVolume+Mute == 15“.
Volume	Volume	Stream-Lautstärke
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Empfängeranwendung definiert wird

Befehle vom Absender an den Empfänger

Mit diesen Befehlen wird der Media Player gesteuert. Alle „customData“-Objekte in den folgenden Nachrichten müssen optional sein. Das bedeutet, dass der Empfänger ordnungsgemäß reagieren sollte, wenn keine Daten übergeben werden. So können generische Fernbedienungs-Apps richtig funktionieren.

Laden

Lädt neue Inhalte in den Mediaplayer.

Name	Typ	Beschreibung
requestId	integer	ID der Anfrage, um Anfrage und Antwort zu korrelieren
type	String	LOAD (nur Wert)
media	MediaInformation	Metadaten (einschließlich contentId) der zu ladenden Media
autoplay	boolean	optional (Standardwert ist „true“): Wenn der Parameter „autoplay“ angegeben ist, beginnt die Wiedergabe des Inhalts im Media-Player, sobald er geladen ist. Auch wenn Autoplay nicht angegeben ist, kann die Implementierung des Mediaplayers die Wiedergabe sofort starten. Wenn die Wiedergabe gestartet wird, sollte der Playerstatus in der Antwort auf „BUFFERING“ gesetzt werden. Andernfalls sollte er auf „PAUSED“ gesetzt werden.
currentTime	double	optional Sekunden seit Beginn des Inhalts. Wenn es sich um Live-Inhalte handelt und keine Position angegeben ist, beginnt der Stream an der Live-Position.
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Senderanwendung definiert wird

Antwort	Trigger	Übertragungen	Fehler
Keine	Änderung des Empfängerstatus	Eine Nachricht zur Änderung des Media-Status	Ungültiger Player-Status Laden fehlgeschlagen Laden abgebrochen

Pausieren

Pausiert die Wiedergabe des aktuellen Inhalts. Löst eine STATUS-Ereignisbenachrichtigung an alle Absenderanwendungen aus.

Name	Typ	Beschreibung
mediaSessionId	integer	ID der zu pausierenden Mediensitzung
requestId	integer	ID der Anfrage, die zum Korrelieren von Anfrage und Antwort verwendet werden soll
type	String	PAUSE (nur Wert)
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Senderanwendung definiert wird

Antwort	Trigger	Übertragungen	Fehler
Keine	Änderung des Empfängerstatus	Eine Nachricht zur Änderung des Media-Status	Ungültiger Player-Status

Suche

Legt die aktuelle Position im Stream fest. Löst eine STATUS-Ereignisbenachrichtigung an alle Absenderanwendungen aus. Wenn die angegebene Position außerhalb des Bereichs gültiger Positionen für die aktuellen Inhalte liegt, sollte der Player eine gültige Position auswählen, die der angeforderten Position so nah wie möglich ist.

Name	Typ	Beschreibung
mediaSessionId	integer	ID der Mediensitzung, in der die Position des Streams festgelegt wird
requestId	integer	ID der Anfrage, um Anfrage und Antwort zu korrelieren
type	String	SEEK (nur Wert)
resumeState	enum (String)	optional Wenn dieser Wert nicht festgelegt ist, ändert sich der Wiedergabestatus nicht. Die folgenden Werte sind möglich: PLAYBACK_START  Erzwingt den Start der Medienwiedergabe PLAYBACK_PAUSE  Erzwingt das Pausieren von Medien.
currentTime	double	optional Sekunden seit Beginn des Inhalts. Wenn es sich um Live-Inhalte handelt und keine Position angegeben ist, beginnt der Stream an der Live-Position.
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Senderanwendung definiert wird

Antwort	Trigger	Übertragungen	Fehler
Keine	Änderung des Empfängerstatus	Eine Nachricht zur Änderung des Media-Status	Ungültiger Player-Status

Beenden

Beendet die Wiedergabe des aktuellen Inhalts. Löst eine STATUS-Ereignisbenachrichtigung an alle Absenderanwendungen aus. Nach diesem Befehl werden die Inhalte nicht mehr geladen und die mediaSessionId wird ungültig.

Name	Typ	Beschreibung
mediaSessionId	integer	ID der Mediensitzung für den Inhalt, der beendet werden soll
requestId	integer	ID der Anfrage, um Anfrage und Antwort zu korrelieren
type	String	STOP (nur Wert)
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Senderanwendung definiert wird

Antwort	Trigger	Übertragungen	Fehler
Keine	Änderung des Empfängerstatus	Eine Nachricht zur Änderung des Media-Status	Ungültiger Player-Status

Play

Die Wiedergabe der mit dem Load-Aufruf geladenen Inhalte wird ab der aktuellen Zeitposition fortgesetzt.

Name	Typ	Beschreibung
mediaSessionId	integer	ID der Mediensitzung für die abzuspielenden Inhalte
requestId	integer	ID der Anfrage, um Anfrage und Antwort zu korrelieren
type	String	PLAY (nur Wert)
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Senderanwendung definiert wird

Antwort	Trigger	Übertragungen	Fehler
Keine	Änderung des Empfängerstatus	Eine Nachricht zur Änderung des Media-Status	Ungültiger Player-Status

Status abrufen

Ruft den Medienstatus ab.

Name	Typ	Beschreibung
mediaSessionId	integer	optional Media-Sitzungs-ID der Media, für die der Media-Status zurückgegeben werden soll. Wenn keine angegeben ist, wird der Status für alle Media-Sitzungs-IDs bereitgestellt.
requestId	integer	ID der Anfrage, um Anfrage und Antwort zu korrelieren
type	String	GET_STATUS (nur Wert)
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Senderanwendung definiert wird

Antwort	Trigger	Übertragungen	Fehler
MediaStatus-Nachricht an den Absender, der sie angefordert hat	Keine	Keine	Keine

SetVolume

Legt die Lautstärke des Media-Streams fest. Wird für Ein- und Ausblendeffekte im Media-Stream verwendet. Hinweis: Die Lautstärke des Empfängers wird über den Web-Absender mit setVolume geändert. Die Streamlautstärke darf nicht in Verbindung mit dem Lautstärkeregler oder den Lautstärketasten verwendet werden, um die Gerätelautstärke zu regeln. Eine Änderung der Streamlautstärke löst keine Benutzeroberfläche auf dem Empfänger aus.

Name	Typ	Beschreibung
mediaSessionId	integer	Media-Sitzungs-ID der Media, für die die Streamlautstärke geändert wird
requestId	integer	ID der Anfrage, um Anfrage und Antwort zu korrelieren
type	String	VOLUMEN (nur Wert)
Volume	Volume	Stream-Lautstärke
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Senderanwendung definiert wird

Antwort	Trigger	Übertragungen	Fehler
Keine	Änderung des Empfängerstatus	Eine Nachricht zur Änderung des Media-Status	Ungültiger Player-Status

Nachrichten vom Empfänger an den Absender

Der Empfänger sendet zwei Arten von Nachrichten:

• Fehler: Unicast-Nachrichten, die gesendet werden, wenn eine Fehlerantwort auf eine Absenderanfrage erfolgt.
• Status: Nachrichten an alle.
  • Folge einer vom Absender initiierten Aktion. Enthält die „requestId“ der Anfrage, die die Änderung verursacht hat.
  • Spontan: Zum Beispiel aufgrund einer Änderung, die von der Empfängeranwendung ausgelöst wurde. Die RequestId ist 0.

Fehler: Ungültiger Player-Status

Wird gesendet, wenn die Anfrage des Absenders nicht erfüllt werden kann, da sich der Player in einem ungültigen Status befindet. Das kann beispielsweise der Fall sein, wenn die Anwendung noch kein Media-Element erstellt hat.

Name	Typ	Beschreibung
requestId	integer	ID der Anfrage, die diesen Fehler verursacht hat
type	String	INVALID_PLAYER_STATE (nur Wert)
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Empfängeranwendung definiert wird

Fehler: Laden fehlgeschlagen

Wird gesendet, wenn die Ladeanfrage fehlgeschlagen ist. Der Player-Status ist IDLE.

Name	Typ	Beschreibung
requestId	integer	ID der Anfrage, die diesen Fehler verursacht hat
type	String	LOAD_FAILED (nur Wert)
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Empfängeranwendung definiert wird

Fehler: Laden abgebrochen

Wird gesendet, wenn die Ladeanfrage abgebrochen wurde (eine zweite Ladeanfrage wurde empfangen).

Name	Typ	Beschreibung
requestId	integer	ID der Anfrage, die diesen Fehler verursacht hat
type	String	LOAD_CANCELLED (einziger Wert)
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Empfängeranwendung definiert wird

Fehler: Ungültige Anfrage

Wird gesendet, wenn die Anfrage ungültig ist (z. B. ein unbekannter Anfragetyp).

Name	Typ	Beschreibung
requestId	integer	ID der Anfrage, die diesen Fehler verursacht hat
type	String	INVALID_REQUEST (nur Wert)
reason	Enum (String)	Werte: INVALID_COMMAND  Der Befehl wird nicht unterstützt. DUPLICATE_REQUESTID  Die Anfrage-ID ist nicht eindeutig (der Empfänger verarbeitet eine Anfrage mit derselben ID).
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Empfängeranwendung definiert wird

Medienstatus

Wird nach einer Statusänderung oder nach einer Anfrage zum Media-Status gesendet. Es werden nur die MediaStatus-Objekte gesendet, die sich geändert haben oder angefordert wurden.

Name	Typ	Beschreibung
requestId	integer	ID, die verwendet wird, um diese Statusantwort mit der Anfrage zu verknüpfen, aus der sie stammt, oder 0, wenn die Statusmeldung spontan ist (nicht durch eine Absenderanfrage ausgelöst). Absenderanwendungen generieren eindeutige Anforderungs-IDs, indem sie eine Zufallszahl auswählen und diese kontinuierlich erhöhen (0 wird nicht verwendet).
type	String	MEDIA_STATUS (nur Wert)
status	MediaStatus[]	Array von Media Status-Objekten. HINWEIS: Das Media-Element in MediaStatus wird nur zurückgegeben, wenn es sich geändert hat.
customData	Objekt	optional Anwendungsspezifisches Blob mit Daten, das von der Empfängeranwendung definiert wird