Google Cast-Senderanwendungen 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, auch in JSON. Bei den Nachrichten kann es sich um Befehle des Absenders handeln, die den Player-Status ändern, um Antworten auf diese Befehle vom Empfänger oder um Datenstrukturen, die die Medien für die Empfängeranwendung beschreiben.
Gemäß den zusätzlichen Nutzungsbedingungen für das Google Cast SDK for Developer muss eine Cast-Medienanwendung die hier definierten Nachrichten verwenden, um die Medienwiedergabe auf dem Empfänger zu steuern. Auf diese Weise wird die Medien-App auf allen Plattformen einheitlich dargestellt und neue Cast-Anwendungen unterstützen neue und zukünftige Anwendungsfälle. Diese Strukturen unterstützen gegebenenfalls auch benutzerdefinierte Daten und eine Anwendung kann eigene Nachrichten für Befehle definieren, die vom SDK nicht unterstützt werden.
Der Namespace für die Nachrichten zur Medienwiedergabe ist als urn:x-cast:com.google.cast.media definiert.
Hinweis: Die Nachrichten und Strukturen in dieser Spezifikation haben eine implizite maximale Größe, die durch die maximale Größe einer Transportnachricht bestimmt wird. Es gibt keine Begrenzung für einzelne Felder. Die maximale Größe der Transportnachricht beträgt derzeit 64 KB.
Gängige Namespace-Datenstrukturen
Eine Obermenge von Datenstrukturen, die von allen Medien-Namespace-Artefakten verwendet werden, ist in einem gemeinsamen Namespace definiert.
Bild
Dies ist die Beschreibung eines Bildes, einschließlich einer kleinen Menge an Metadaten, damit der Absender der Anwendung je nach Darstellung verschiedene Bilder auswählen kann.
Höhe und Breite sind nur für ein Element in einem Bilder-Array optional. Wenn beispielsweise ein einzelner Artikel zurückgegeben wird, sind diese optional. Sind zwei Elemente zurückgegeben, muss für ein Element eine Höhe und Breite angegeben werden. Der Absender kann sich jedoch für die Standardoption entscheiden, wenn er nicht mit dem angegebenen Parameter übereinstimmt.
| Name | Typ | Beschreibung |
|---|---|---|
| URL | URI | URI für das Bild |
| Höhe | integer | Optional: Höhe des Bildes |
| Breite | integer | Optional: Breite des Bildes |
Lautstärke
Die Lautstärke des Medienstreams. Wird für Ein- und Ausblendungen im Medienstream verwendet. Hinweis: Das Systemvolumen wird über die Sender APIs geändert. Die Lautstärke des Streams darf nicht zusammen mit dem Lautstärkeregler oder den Lautstärketasten verwendet werden. Es muss mindestens einer der folgenden Parameter übergeben werden, um das Streamvolumen zu ändern.
| Name | Typ | Beschreibung |
|---|---|---|
| Level | double | Optional: Die aktuelle Lautstärke des Streams ist ein Wert zwischen 0,0 und 1,0. 1,0. |
| stummgeschaltet | boolean | optional – unabhängig davon, ob das Cast-Gerät stummgeschaltet ist |
Media Namespace-Datenstrukturen
Diese Meldungen beschreiben den Status des Mediaplayers. Der Namespace lautet urn:x-cast:com.google.cast.media.
Medieninformationen
Diese Datenstruktur beschreibt einen Medienstream.
| Name | Typ | Beschreibung |
|---|---|---|
| contentId | String | Dienstspezifische Kennung des Inhalts, der derzeit vom Mediaplayer geladen wird. Das ist ein frei definierbarer String für die jeweilige Anwendung. In den meisten Fällen ist dies die URL zu den Medien, aber der Absender kann einen String übergeben, der vom Empfänger richtig interpretiert werden kann. Maximale Länge: 1 KB |
| streamType | Aufzählung (String) |
Beschreibt den Typ des Medienartefakts als eines der folgenden:
|
| contentType | String | MIME-Inhaltstyp der Medien, die wiedergegeben werden |
| metadata | Objekt | optional: eines der folgenden Metadatenobjekte: |
| Dauer | double | optional: die Dauer des aktuell wiedergegebenen Streams in Sekunden |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die entweder von der Absenderanwendung oder der Empfängeranwendung definiert wurden. |
GenericMediaMetadata
Beschreibt ein generisches Medienartefakt.
| Name | Typ | Beschreibung |
|---|---|---|
| metadataType | integer | 0 (der einzige Wert) |
| title | String | Optional. Beschreibender Titel des Inhalts. Der Spieler kann den Titel unabhängig mit der content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| Untertitel | String | Optional: Beschreibender Untertitel des Inhalts. Der Spieler kann den Titel unabhängig mit der content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| Bilder | Bild[] | Optional: Ein Array von URLs zu einem Bild, das dem Inhalt zugeordnet ist. Der Anfangswert des Feldes kann vom Absender in der Nachricht Load angegeben werden. Es sollten empfohlene Größen angegeben werden. |
| releaseDate | String (ISO 8601) | optional. Datum und Uhrzeit der Veröffentlichung dieses Inhalts gemäß ISO 8601. Der Spieler kann den Titel unabhängig mit der content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
Filmmedien-Metadaten
Beschreibt ein Filmmedienartefakt.
| Name | Typ | Beschreibung |
|---|---|---|
| metadataType | integer | 1 (der einzige Wert) |
| title | String | Optional. Beschreibender Titel des Inhalts. Der Spieler kann den Titel unabhängig mit der content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| Untertitel | String | Optional: Beschreibender Untertitel des Inhalts. Der Spieler kann den Titel unabhängig mit der 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 mit der Content-ID unabhängig abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| Bilder | Bild[] | Optional: Ein Array von URLs zu einem Bild, das dem Inhalt zugeordnet ist. Der Anfangswert des Feldes kann vom Absender in der Nachricht Load angegeben werden. Es sollten empfohlene Größen angegeben werden. |
| releaseDate | String (ISO 8601) | optional. Datum und Uhrzeit der Veröffentlichung dieses Inhalts gemäß ISO 8601. Der Spieler kann den Titel unabhängig mit der content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
TVShowMediaMetadata
Beschreibt das Medienartefakt einer TV-Sendung.
| Name | Typ | Beschreibung |
|---|---|---|
| metadataType | integer | 2 (der einzige Wert) |
| Serientitel | String | Optional. Beschreibender Titel der TV-Serie. Der Spieler kann den Titel unabhängig mit der content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| Untertitel | String | optional: Beschreibender Untertitel der TV-Folge. Der Spieler kann den Titel unabhängig mit der content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| saison | integer | optional Staffel für die Serie |
| Folge | integer | optional: Nummer der Folge (in der Staffel) der TV-Sendung |
| Bilder | Bild[] | Optional: Ein Array von URLs zu einem Bild, das dem Inhalt zugeordnet ist. Der Anfangswert des Feldes kann vom Absender in der Nachricht Load angegeben werden. Es sollten empfohlene Größen angegeben werden. |
| originalAirDate | String (ISO 8601) | optional. Datum und Uhrzeit der ISO 8601-Veröffentlichung dieser Folge. Der Player kann „originalAirDate“ mithilfe von „content_id“ unabhängig abrufen oder der Absender sendet ihn in der Load-Nachricht |
MediaTrackMediaMetadata
Beschreibt ein Artefakt für Musiktitel.
| Name | Typ | Beschreibung |
|---|---|---|
| metadataType | integer | 3 (der einzige Wert) |
| Albumname | String | optional: Album oder Sammlung, aus dem der Titel stammt Der Spieler kann „albumName“ mit „content_id“ unabhängig abrufen oder der Absender gibt ihn in der Nachricht Load (Laden) ein. |
| title | String | optional: Name des Titels, z. B. Songtitel Der Spieler kann den Titel unabhängig mit der content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| Albumkünstler | String | optional: Name des Künstlers, der dem Album mit diesem Titel zugeordnet ist Der Spieler kann „albumArtist“ mithilfe von „content_id“ unabhängig voneinander abrufen. Alternativ kann er vom Absender in der Load-Nachricht angegeben werden. |
| Künstler | String | optional: Name des Künstlers, der dem Media-Track zugeordnet ist Der Spieler kann den Interpret selbst mithilfe von content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| composer | String | Optional. Der Name des Komponisten, der dem Medien-Track zugeordnet ist. Der Spieler kann den Composer unabhängig mithilfe von „content_id“ abrufen oder der Absender kann ihn in der Load-Nachricht angeben. |
| Titelnummer | integer | optional: die Nummer des Titels im Album |
| DiscNumber | integer | optional: die Bandnummer des Albums (z. B. eine CD) |
| Bilder | Bild[] | Optional: Ein Array von URLs zu einem Bild, das dem Inhalt zugeordnet ist. Der Anfangswert des Feldes kann vom Absender in der Nachricht Load angegeben werden. Es sollten empfohlene Größen angegeben werden. |
| releaseDate | String (ISO 8601) | optional. Datum und Uhrzeit der Veröffentlichung dieses Inhalts gemäß ISO 8601. Der Spieler kann das releaseDate mit der content_id selbst abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden |
PhotoMediaMetadata
Beschreibt ein Artefakt für fotografische Medien.
| Name | Typ | Beschreibung |
|---|---|---|
| metadataType | integer | 4 (der einzige Wert) |
| title | String | Optional. Titel des Fotos. Der Spieler kann den Titel unabhängig mit der content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| Künstler | String | Optional: Name des Fotografen. Der Spieler kann den Interpret selbst mithilfe von content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| den Standort | String | optional. Der mündliche Ort, an dem das Foto aufgenommen wurde, z. B. "Madrid, Spanien". Der Spieler kann den Standort mithilfe von content_id unabhängig abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| latitude | double | Optional: Der geografische Breitengrad des Ortes, an dem das Foto aufgenommen wurde. Der Spieler kann den Breitengrad unabhängig mit der content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| longitude | double | Optional: Der geografische Längengrad des Ortes, an dem das Foto aufgenommen wurde. Der Spieler kann den Längengrad unabhängig mit content_id abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| Breite | integer | Optional: Breite des Fotos in Pixeln. Der Player kann die Breite mithilfe von content_id unabhängig abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| Höhe | integer | optional: Höhe des Fotos in Pixeln Der Spieler kann die Höhe mithilfe von content_id unabhängig abrufen oder er kann vom Absender in der Load-Nachricht angegeben werden. |
| creationDateTime | String (ISO 8601) | Optional: Datum und Uhrzeit der Aufnahme dieses Fotos nach ISO 8601. Der Spieler kann die Eigenschaft „dateDateTime“ mithilfe von „content_id“ unabhängig voneinander abrufen. Sie kann aber auch vom Absender in der Load-Nachricht angegeben werden. |
Medienstatus
Beschreibt den aktuellen Status des Medienartefakts in Bezug auf die Sitzung.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId (MediaSessionId) | integer | Eindeutige ID für die Wiedergabe dieser spezifischen Sitzung. Diese ID wird vom Empfänger unter LOAD festgelegt und kann zur Identifizierung einer bestimmten Instanz einer Wiedergabe verwendet werden. Zum Beispiel hätten zwei Wiedergaben von „Wünschst du mir schon“ innerhalb derselben Sitzung jeweils eine eindeutige mediaSessionId. |
| Medien | Medieninformationen | Optional (für Statusmeldungen) Eine vollständige Beschreibung der Inhalte, die wiedergegeben werden. Wird nur in Statusmeldungen zurückgegeben, wenn „MediaInformation“ geändert wurde. |
| playbackRate (Wiedergaberate) | float | Gibt an, ob und wie schnell die Medienzeit abgespielt wird. Dies ist unabhängig vom Player-Status, da die Medienzeit in jedem Zustand stoppen kann. 1,0 entspricht der normalen Zeit, 0,5 der Zeitlupe |
| Spielerstatus | Aufzählung (String) | Der Status des Players lässt sich folgendermaßen beschreiben:
|
| idleReason | Aufzählung (String) | optional. Wenn „playerState“ IDLE ist und der Grund dafür angegeben ist, dass es „IDLE“ ist, wird diese Property angegeben. Wenn der Player IDLE gehört, weil er gerade gestartet wurde, wird diese Eigenschaft nicht bereitgestellt. Wenn sich der Player in einem anderen Zustand befindet, sollte diese Eigenschaft nicht angegeben werden. Folgende Werte gelten:
|
| aktuellZeit | double | Die aktuelle Position des Mediaplayers seit Beginn des Contents in Sekunden. Wenn es sich um einen Livestreaminhalt handelt, wird in diesem Feld die Zeit in Sekunden ab Beginn des Ereignisses angegeben, die dem Player bekannt sein sollte. |
| supportedMediaCommands | flags | Flags, die beschreiben, welche Medienbefehle der Mediaplayer unterstützt:
Kombinationen werden als Additionen beschrieben. Beispiel: Pause + Suche + Stream-Lautstärke + Stummschaltung = 15. |
| Volume | Volume | Streamlautstärke |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Empfängeranwendung definiert wurden. |
Befehle vom Absender zum Empfänger
Mit diesen Befehlen wird der Mediaplayer gesteuert. Alle „customData“-Objekte in den Nachrichten unten müssen optional sein. Das heißt, der Empfänger sollte richtig funktionieren, wenn keine Daten übergeben werden. Dadurch funktionieren allgemeine Fernbedienungs-Apps ordnungsgemäß.
Laden
Lädt neue Inhalte in den Mediaplayer.
| Name | Typ | Beschreibung |
|---|---|---|
| requestId | integer | ID der Anfrage, um Anfrage und Antwort zu korrelieren |
| Typ | String | LOAD (nur Wert) |
| Medien | Medieninformationen | Metadaten (einschließlich contentId) der zu ladenden Medien |
| Autoplay | boolean | optional(Standardeinstellung ist „true“). Wenn der Parameter für die automatische Wiedergabe angegeben ist, beginnt der Mediaplayer mit der Wiedergabe des Inhalts, sobald er geladen ist. Auch wenn die Autoplay-Funktion nicht angegeben ist, wird die Wiedergabe des Mediaplayers möglicherweise sofort gestartet. Wenn die Wiedergabe gestartet wird, sollte der Player-Status in der Antwort auf „BUFFERING“ oder auf „PAUSE“ gesetzt sein. |
| aktuellZeit | double | optional: Sekunden seit Beginn des Contents Wenn es sich um Liveinhalte handelt und die Position nicht angegeben ist, beginnt der Stream an der Liveposition. |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Absenderanwendung definiert wurden. |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| – | Änderung des Empfängerstatus | Nachricht zum Ändern des Medienstatus | Ungültiger Player-Status Fehler beim Laden Abgebrochen |
Pausieren
Pausiert die Wiedergabe des aktuellen Inhalts. Löst eine Ereignisbenachrichtigung zum Status STATUS an alle Absenderanwendungen aus.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId (MediaSessionId) | integer | ID der Mediensitzung, die pausiert werden soll |
| requestId | integer | ID der Anfrage, mit der die Anfrage/Antwort korreliert wird |
| Typ | String | PAUSE (nur Wert) |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Absenderanwendung definiert wurden. |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| – | Änderung des Empfängerstatus | Nachricht zum Ändern des Medienstatus | Ungültiger Player-Status |
Suchen
Legt die aktuelle Position im Stream fest. Löst eine Ereignisbenachrichtigung zum Status STATUS an alle Absenderanwendungen aus. Wenn die angegebene Position außerhalb des Bereichs der gültigen Positionen für den aktuellen Inhalt liegt, sollte der Player eine gültige Position möglichst nahe an der angeforderten Position auswählen.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId (MediaSessionId) | integer | ID der Mediensitzung, in der die Position des Streams festgelegt ist |
| requestId | integer | ID der Anfrage, um Anfrage und Antwort zu korrelieren |
| Typ | String | SEEK (nur Wert) |
| Fortsetzen | Aufzählung (String) | Optional: Wenn diese Richtlinie nicht konfiguriert ist, ändert sich der Wiedergabestatus nicht. Es gelten die folgenden Werte:
|
| aktuellZeit | double | optional: Sekunden seit Beginn des Contents Wenn es sich um Liveinhalte handelt und die Position nicht angegeben ist, beginnt der Stream an der Liveposition. |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Absenderanwendung definiert wurden. |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| – | Änderung des Empfängerstatus | Nachricht zum Ändern des Medienstatus | Ungültiger Player-Status |
Beenden
Stoppt die Wiedergabe des aktuellen Inhalts. Löst eine Ereignisbenachrichtigung zum Status STATUS an alle Absenderanwendungen aus. Nach diesem Befehl wird der Inhalt nicht mehr geladen und die mediaSessionId ist ungültig.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId (MediaSessionId) | integer | ID der Mediensitzung, für die der Content gestoppt werden soll |
| requestId | integer | ID der Anfrage, um Anfrage und Antwort zu korrelieren |
| Typ | String | STOP(nur Wert) |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Absenderanwendung definiert wurden. |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| – | Änderung des Empfängerstatus | Nachricht zum Ändern des Medienstatus | Ungültiger Player-Status |
Wiedergeben
Startet die Wiedergabe des Inhalts, der mit dem Ladeaufruf geladen wurde. Die Wiedergabe wird ab der aktuellen Zeitposition fortgesetzt.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId (MediaSessionId) | integer | ID der Mediensitzung für den Inhalt, der wiedergegeben werden soll |
| requestId | integer | ID der Anfrage, um Anfrage und Antwort zu korrelieren |
| Typ | String | PLAY(nur Wert) |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Absenderanwendung definiert wurden. |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| – | Änderung des Empfängerstatus | Nachricht zum Ändern des Medienstatus | Ungültiger Player-Status |
Status abrufen
Ruft den Medienstatus ab.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId (MediaSessionId) | integer | Optional. Mediasitzungs-ID des Mediums, für das der Medienstatus zurückgegeben werden soll. Wenn keine angegeben ist, wird der Status für alle Mediensitzungs-IDs angegeben. |
| requestId | integer | ID der Anfrage, um Anfrage und Antwort zu korrelieren |
| Typ | String | GET_STATUS (nur Wert) |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Absenderanwendung definiert wurden. |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| MediaStatus-Nachricht an den Absender, der sie angefordert hat | – | – | – |
Lautstärke festlegen
Legt die Lautstärke des Medienstreams fest. Wird für Ein- und Ausblendungen im Medienstream verwendet. Hinweis: Die Empfängerlautstärke wird über den Websender setVolume geändert. Die Streamlautstärke darf nicht zusammen mit dem Lautstärkeregler oder den Lautstärketasten verwendet werden, um die Gerätelautstärke zu steuern. Eine Änderung der Stream-Lautstärke löst keine Benutzeroberfläche auf dem Empfänger aus.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId (MediaSessionId) | integer | Mediensitzungs-ID des Mediums, für das das Streamvolumen geändert wird |
| requestId | integer | ID der Anfrage, um Anfrage und Antwort zu korrelieren |
| Typ | String | VOLUME(nur Wert) |
| Volume | Volume | Streamlautstärke |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Absenderanwendung definiert wurden. |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| – | Änderung des Empfängerstatus | Nachricht zum Ändern des Medienstatus | Ungültiger Player-Status |
Nachrichten vom Empfänger zum Absender
Der Empfänger sendet zwei Arten von Nachrichten:
- Fehler: Unicast-Nachrichten, die gesendet werden, wenn eine Fehlerantwort auf eine Absenderanfrage vorliegt.
- Status: Nachricht 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 wird. Die Anfrage-ID ist 0.
Fehler: Ungültiger Player-Status
Wird ausgelöst, wenn die Anfrage des Absenders nicht erfüllt werden kann, weil der Player nicht gültig ist. Das ist beispielsweise der Fall, wenn in der Anwendung noch kein Mediaplan erstellt wurde.
| Name | Typ | Beschreibung |
|---|---|---|
| requestId | integer | ID der Anfrage, die diesen Fehler generiert hat |
| Typ | String | INVALID_player_STATE (nur Wert) |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Empfängeranwendung definiert wurden. |
Fehler: Laden fehlgeschlagen
Wird gesendet, wenn die Ladeanfrage fehlgeschlagen ist. Der Player-Status lautet IDLE.
| Name | Typ | Beschreibung |
|---|---|---|
| requestId | integer | ID der Anfrage, die diesen Fehler generiert hat |
| Typ | String | LOAD_FAILED (nur Wert) |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Empfängeranwendung definiert wurden. |
Fehler: Ladevorgang abgebrochen
Wird gesendet, wenn die Ladeanfrage abgebrochen wurde (z. B. eine zweite Ladeanfrage empfangen wurde).
| Name | Typ | Beschreibung |
|---|---|---|
| requestId | integer | ID der Anfrage, die diesen Fehler generiert hat |
| Typ | String | LOAD_CANCELLED (nur Wert) |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Empfängeranwendung definiert wurden. |
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 generiert hat |
| Typ | String | INVALID_REQUEST (nur Wert) |
| Grund | Enum (String) | Werte:
|
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Empfängeranwendung definiert wurden. |
Medienstatus
Wird nach einer Statusänderung oder nach einer Medienstatusanfrage gesendet. Es werden nur die MediaStatus-Objekte gesendet, die geändert oder angefordert wurden.
| Name | Typ | Beschreibung |
|---|---|---|
| requestId | integer | ID, die dieser Statusantwort mit der Anfrage, die sie gesendet hat, oder 0 zugeordnet ist, wenn die Statusnachricht spontan ist (nicht durch eine Absenderanfrage ausgelöst wird). Senderanwendungen generieren eindeutige Anfrage-IDs, indem sie eine Zufallszahl auswählen und kontinuierlich erhöhen (sie werden nicht 0 verwenden). |
| Typ | String | MEDIA_STATUS (nur Wert) |
| Status | MediaStatus | Array mit Medienstatusobjekten HINWEIS: Das Mediaelement in MediaStatus wird nur zurückgegeben, wenn es geändert wurde. |
| customData | Objekt | Optional. Anwendungsspezifisches Blob mit Daten, die von der Empfängeranwendung definiert wurden. |