Google Cast-Sender-Apps steuern die Wiedergabe auf dem Empfängergerät, indem sie Nachrichten im JSON-Format an die Empfänger-App senden. Ebenso sendet der Empfänger Nachrichten im JSON-Format an den Absender zurück. Die Nachrichten können Befehle des Senders sein, die den Player-Status ändern, Antworten auf diese Befehle des Empfängers oder Datenstrukturen, die die Medien für die Empfänger-App beschreiben.
Gemäß den zusätzlichen Nutzungsbedingungen für das Google Cast SDK muss eine Cast-Medien-App diese Nachrichten wie hier definiert verwenden, um die Medienwiedergabe auf dem Empfänger zu steuern. Dadurch wird die Medien-App plattformübergreifend einheitlich genutzt und eine Cast-App wird neue und zukünftige Anwendungsfälle unterstützen. Diese Strukturen unterstützen gegebenenfalls auch benutzerdefinierte Daten und eine Anwendung kann ihre eigenen Nachrichten für Befehle definieren, die nicht vom SDK 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 Maximalgröße, die durch die maximale Größe einer Transportnachricht bestimmt wird. Es gibt keine Beschränkung für einzelne Felder. Die maximale Größe der Transportnachricht beträgt derzeit 64 KB.
Allgemeine 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 einiger Metadaten, damit die Absenderanwendung die Bilder je nach Darstellung auswählen kann.
Höhe und Breite sind nur bei einem Element aus einem Bilder-Array optional. Wenn beispielsweise ein einzelner Artikel zurückgegeben wird, sind diese optional. Wenn zwei Artikel zurückgegeben werden, muss bei einem Artikel Höhe und Breite angegeben werden. Der Absender kann jedoch die Standardoption wählen, wenn dies nicht der Fall ist, der mit bestimmten Parametern übergeben wurde.
| Name | Typ | Beschreibung |
|---|---|---|
| URL | URI | URI für das Bild |
| Höhe | Ganzzahl | Optional Höhe des Bildes |
| Breite | Ganzzahl | Optional Breite des Bildes |
Volumen
Die Lautstärke des Medienstreams. Wird für Ein-/Aus-Effekte im Mediastream verwendet. Hinweis: Das System-Volume wird mithilfe der 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. Zum Ändern der Streamlautstärke muss mindestens einer der folgenden Parameter übergeben werden.
| Name | Typ | Beschreibung |
|---|---|---|
| Ebene | Doppelwert | optional : Die aktuelle Stream-Lautstärke ist ein Wert zwischen 0,0 und 1,0, wobei 1,0 die maximale Lautstärke ist. |
| stummgeschaltet | boolean | Optional : Gibt an, ob das Übertragungsgerät stummgeschaltet ist, unabhängig von der Lautstärke |
Medien-Namespace-Datenstrukturen
Diese Meldungen beschreiben den Status des Mediaplayers. Der Namespace lautet urn:x-cast:com.google.cast.media.
MediaInformation
Diese Datenstruktur beschreibt einen Medienstream.
| Name | Typ | Beschreibung |
|---|---|---|
| contentId | String | Dienstspezifische Kennung der Inhalte, die derzeit vom Mediaplayer geladen werden. Dies ist ein frei definierbarer String, der anwendungsspezifisch ist. In den meisten Fällen ist dies die URL zu den Medien, aber der Absender kann einen String weitergeben, den der Empfänger richtig interpretieren kann. Maximale Länge: 1.000 |
| streamType | Aufzählung (String) |
Beschreibt den Typ des Medienartefakts wie folgt:
|
| contentType | String | MIME-Inhaltstyp der wiedergegebenen Medien |
| metadata | Objekt | optional : Das Medienmetadatenobjekt, eine der folgenden Optionen: |
| Dauer | Doppelwert | optional : Dauer des aktuell wiedergegebenen Streams in Sekunden |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Senderanwendung oder der Empfängeranwendung definiert wird |
GenericMediaMetadata
Beschreibt ein generisches Medienartefakt.
| Name | Typ | Beschreibung |
|---|---|---|
| metadataType | Ganzzahl | 0 (der einzige Wert) |
| title | String | optional : Ein aussagekräftiger Titel des Inhalts Der Player kann den Titel unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| Untertitel | String | Optional . Ein aussagekräftiger Untertitel des Inhalts. Der Player kann den Titel unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| Bilder | Bild[] | optional Array von URLs zu einem Bild, das dem Content zugeordnet ist Der Anfangswert des Felds kann vom Absender in der Load-Nachricht angegeben werden. Empfohlene Größen erforderlich |
| releaseDate | String (ISO 8601) | optional : Datum und Uhrzeit der Veröffentlichung dieses Inhalts nach ISO 8601 Der Player kann den Titel unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
MovieMediaMetadata
Beschreibt ein Filmmedienartefakt.
| Name | Typ | Beschreibung |
|---|---|---|
| metadataType | Ganzzahl | 1 (der einzige Wert) |
| title | String | optional : Ein aussagekräftiger Titel des Inhalts Der Player kann den Titel unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| Untertitel | String | Optional . Ein aussagekräftiger Untertitel des Inhalts. Der Player kann den Titel unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| Studio | String | optional : Studio, das den Inhalt veröffentlicht hat Der Player kann Studio unabhängig voneinander mithilfe von "content_id" abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| Bilder | Bild[] | optional Array von URLs zu einem Bild, das dem Content zugeordnet ist Der Anfangswert des Felds kann vom Absender in der Load-Nachricht angegeben werden. Empfohlene Größen erforderlich |
| releaseDate | String (ISO 8601) | optional : Datum und Uhrzeit der Veröffentlichung dieses Inhalts nach ISO 8601 Der Player kann den Titel unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
TvShowMediaMetadata
Beschreibt ein Medienartefakt für Folgen einer TV-Sendung.
| Name | Typ | Beschreibung |
|---|---|---|
| metadataType | Ganzzahl | 2 (der einzige Wert) |
| seriesTitle | String | optional : Ein aussagekräftiger Titel der TV-Serie Der Player kann den Titel unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| Untertitel | String | optional : Beschreibender Untertitel der TV-Folge. Der Player kann den Titel unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| Saison | Ganzzahl | optional : Staffelnummer der TV-Sendung |
| Folge | Ganzzahl | optional : Nummer der Folge (in der Staffel) der TV-Sendung |
| Bilder | Bild[] | optional Array von URLs zu einem Bild, das dem Content zugeordnet ist Der Anfangswert des Felds kann vom Absender in der Load-Nachricht angegeben werden. Empfohlene Größen erforderlich |
| originalAirDate | String (ISO 8601) | optional : Datum und Uhrzeit der Veröffentlichung dieser Folge gemäß ISO 8601. Der Player kann originalAirDate unabhängig mithilfe von content_id abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
MusicTrackMediaMetadata
Beschreibt ein Medienartefakt eines Musiktitels.
| Name | Typ | Beschreibung |
|---|---|---|
| metadataType | Ganzzahl | 3 (der einzige Wert) |
| albumName | String | optional : Album oder Sammlung, aus dem dieser Titel stammt Der Player kann „albumName“ unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| title | String | optional : Name des Titels, z. B. Songtitel Der Player kann den Titel unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| albumArtist | String | optional : Name des Künstlers, der mit dem Album mit diesem Titel verknüpft ist Der Player kann den Künstler des Albums unabhängig über „content_id“ abrufen oder sie kann vom Absender in der Nachricht Load (Laden) angegeben werden. |
| Künstler | String | optional : Name des Künstlers, der mit dem Mediatrack verknüpft ist Der Player kann den Künstler unabhängig mithilfe von "content_id" abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| composer | String | Optional : Der Name des Komponisten, der mit dem Medientrack verknüpft ist. Der Player kann den Komponisten unabhängig mithilfe von "content_id" abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| trackNumber | Ganzzahl | optional Nummer des Titels auf dem Album |
| discNumber | Ganzzahl | optional Nummer des Bandes, zum Beispiel einer CD |
| Bilder | Bild[] | optional Array von URLs zu einem Bild, das dem Content zugeordnet ist Der Anfangswert des Felds kann vom Absender in der Load-Nachricht angegeben werden. Empfohlene Größen erforderlich |
| releaseDate | String (ISO 8601) | optional : Datum und Uhrzeit der Veröffentlichung dieses Inhalts nach ISO 8601 Der Player kann das Release-Datum unabhängig über „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
PhotoMediaMetadata
Beschreibt ein fotografisches Medienartefakt.
| Name | Typ | Beschreibung |
|---|---|---|
| metadataType | Ganzzahl | 4 (der einzige Wert) |
| title | String | optional : Titel des Fotos Der Player kann den Titel unabhängig mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| Künstler | String | Optional : Der Name des Fotografen Der Player kann den Künstler unabhängig mithilfe von "content_id" abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| den Standort | String | optional : Angaben zum Aufnahmeort des Fotos, zum Beispiel "Madrid, Spanien" Der Player kann den Standort unabhängig mithilfe von "content_id" abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| latitude | Doppelwert | optional : Wert für den geografischen Breitengrad des Ortes, an dem das Foto aufgenommen wurde Der Player kann den Breitengrad unabhängig mithilfe von "content_id" abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| longitude | Doppelwert | optional : Wert für den geografischen Längengrad des Ortes, an dem das Foto aufgenommen wurde Der Player kann den Längengrad unabhängig mithilfe von "content_id" abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
| Breite | Ganzzahl | optional : Die Breite des Fotos in Pixeln. Der Player kann die Breite unabhängig mithilfe von "content_id" abrufen oder sie kann vom Absender in der Load-Nachricht angegeben werden. |
| Höhe | Ganzzahl | Optional : Höhe des Fotos in Pixeln Der Player kann die Größe unabhängig mithilfe von "content_id" abrufen oder sie kann vom Absender in der Load-Nachricht angegeben werden. |
| creationDateTime | String (ISO 8601) | optional Datum und Uhrzeit der Aufnahme gemäß ISO 8601 Der Player kann „createDateTime unabhängig“ mithilfe von „content_id“ abrufen oder vom Absender in der Load-Nachricht angegeben werden. |
MediaStatus
Beschreibt den aktuellen Status des Medienartefakts in Bezug auf die Sitzung.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId | Ganzzahl | Eindeutige ID für die Wiedergabe dieser bestimmten Sitzung. Diese ID wird vom Empfänger unter LOAD festgelegt und kann verwendet werden, um eine bestimmte Instanz einer Wiedergabe zu identifizieren. So haben beispielsweise zwei Wiedergaben von „Du wärst hier“ innerhalb derselben Sitzung jeweils eine eindeutige mediaSessionId. |
| Medien | MediaInformation | optional (für Statusmeldungen): Vollständige Beschreibung des wiedergegebenen Inhalts werden nur in Statusmeldungen zurückgegeben, wenn sich die MediaInformation geändert hat. |
| playbackRate | float | Gibt an, ob und mit welcher Geschwindigkeit die Medienzeit läuft. Dies ist unabhängig vom Player-Status, da die Medienzeit in jedem Zustand beendet werden kann. 1,0 ist die reguläre Zeit, 0,5 ist Zeitlupe. |
| playerState | enum (String) | Beschreibt den Player-Status wie folgt:
|
| idleReason | enum (String) | optional : Wenn „playerState“ auf „INLE“ gesetzt ist und der Grund dafür bekannt ist, wird diese Eigenschaft angegeben. Wenn sich der Player gerade befindet, weil er gerade gestartet wurde, wird diese Eigenschaft nicht angegeben. Befindet sich der Player in einem anderen Status, sollte diese Eigenschaft nicht angegeben werden. Die folgenden Werte gelten:
|
| currentTime | Doppelwert | Die aktuelle Position des Mediaplayers seit Beginn des Inhalts in Sekunden. Bei einem Livestream-Content enthält dieses Feld die Zeit in Sekunden ab Beginn des Ereignisses, die dem Player bekannt sein sollte. |
| supportedMediaCommands | flags | Flags, die beschreiben, welche Medienbefehle der Mediaplayer unterstützt:
Kombinationen werden als Summen beschrieben. Beispiel: Pause+Seek+StreamVolume+Mute == 15. |
| Volume | Volume | Stream-Lautstärke |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Empfängeranwendung definiert wird |
Befehle vom Sender an den Empfänger
Mit diesen Befehlen wird der Mediaplayer gesteuert. Alle customData-Objekte in den unten stehenden Nachrichten müssen optional sein, d.h., der Empfänger sollte sich ordnungsgemäß verschlechtern, wenn keine Daten übergeben werden. So funktionieren allgemeine Fernbedienungs-Apps ordnungsgemäß.
Laden
Lädt neue Inhalte in den Mediaplayer
| Name | Typ | Beschreibung |
|---|---|---|
| requestId | Ganzzahl | ID der Anfrage, um Anfrage und Antwort in Beziehung zu setzen |
| Typ | String | LOAD (nur Wert) |
| Medien | MediaInformation | Metadaten (einschließlich contentId) der zu ladenden Medien |
| Autoplay | boolean | optional : Der Standardwert ist „true“. Wenn der Parameter „autoplay“ angegeben ist, beginnt der Mediaplayer die Wiedergabe des Inhalts, sobald er geladen wurde. Auch wenn Autoplay nicht festgelegt ist, kann bei der Mediaplayer-Implementierung die Wiedergabe sofort gestartet werden. Wenn die Wiedergabe gestartet wird, sollte der Player-Status in der Antwort auf „BUFFERING“ gesetzt werden. Andernfalls sollte er auf „PAUSE“ gesetzt werden. |
| currentTime | Doppelwert | optional Sekunden seit Beginn des Inhalts Wenn es sich um Live-Inhalte handelt und keine Position angegeben ist, startet der Stream an der Live-Position. |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Absenderanwendung definiert wird |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| Keine | Änderung des Empfängerstatus | Eine Nachricht zur Statusänderung von Medien | Ungültiger Player-Status Laden fehlgeschlagen Laden abgebrochen |
Pausieren
Pausiert die Wiedergabe des aktuellen Inhalts. Löst eine Benachrichtigung über ein STATUS-Ereignis an alle Absenderanwendungen aus.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId | Ganzzahl | ID der zu pausierenden Mediensitzung |
| requestId | Ganzzahl | ID der Anfrage, die zum Korrelieren von Anfrage/Antwort verwendet werden soll |
| Typ | String | PAUSE (nur Wert) |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Absenderanwendung definiert wird |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| Keine | Änderung des Empfängerstatus | Eine Nachricht zur Statusänderung von Medien | Ungültiger Player-Status |
Suchen
Legt die aktuelle Position im Stream fest. Löst eine Benachrichtigung über ein STATUS-Ereignis an alle Absenderanwendungen aus. Wenn die angegebene Position außerhalb des Bereichs der gültigen Positionen für den aktuellen Content liegt, sollte der Player eine gültige Position auswählen, die der angeforderten Position möglichst nahe kommt.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId | Ganzzahl | ID der Mediensitzung, in der die Position des Streams festgelegt ist |
| requestId | Ganzzahl | ID der Anfrage, um Anfrage und Antwort in Beziehung zu setzen |
| Typ | String | SEEK (nur Wert) |
| resumeState | enum (String) | optional : Ist die Richtlinie nicht konfiguriert, ändert sich der Wiedergabestatus nicht. Die folgenden Werte gelten:
|
| currentTime | Doppelwert | optional Sekunden seit Beginn des Inhalts Wenn es sich um Live-Inhalte handelt und keine Position angegeben ist, startet der Stream an der Live-Position. |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Absenderanwendung definiert wird |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| Keine | Änderung des Empfängerstatus | Eine Nachricht zur Statusänderung von Medien | Ungültiger Player-Status |
Beenden
Stoppt die Wiedergabe des aktuellen Inhalts. Löst eine Benachrichtigung über ein STATUS-Ereignis an alle Absenderanwendungen aus. Nach diesem Befehl wird der Inhalt nicht mehr geladen und die mediaSessionId wird ungültig.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId | Ganzzahl | ID der Mediensitzung, die beendet werden soll |
| requestId | Ganzzahl | ID der Anfrage, um Anfrage und Antwort in Beziehung zu setzen |
| Typ | String | STOPP (nur Wert) |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Absenderanwendung definiert wird |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| Keine | Änderung des Empfängerstatus | Eine Nachricht zur Statusänderung von Medien | 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 | Ganzzahl | ID der Mediensitzung für den Inhalt, der abgespielt werden soll |
| requestId | Ganzzahl | ID der Anfrage, um Anfrage und Antwort in Beziehung zu setzen |
| Typ | String | PLAY (nur Wert) |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Absenderanwendung definiert wird |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| Keine | Änderung des Empfängerstatus | Eine Nachricht zur Statusänderung von Medien | Ungültiger Player-Status |
Status abrufen
Ruft den Medienstatus ab.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId | Ganzzahl | Optional – ID der Mediensitzung, für die der Medienstatus zurückgegeben werden soll Wenn keine angegeben ist, wird der Status für alle Mediensitzungs-IDs angegeben. |
| requestId | Ganzzahl | ID der Anfrage, um Anfrage und Antwort in Beziehung zu setzen |
| Typ | String | GET_STATUS (nur Wert) |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Absenderanwendung definiert wird |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| MediaStatus-Nachricht an den Absender | Keine | Keine | Keine |
SetVolume
Legt die Lautstärke des Medienstreams fest. Wird für Ein-/Aus-Effekte im Mediastream verwendet. (Hinweis: Die Lautstärke des Empfängers wird mit setVolume des Websenders geändert.) Die Stream-Lautstärke darf nicht in Verbindung mit dem Lautstärkeregler oder Lautstärketasten verwendet werden, um die Gerätelautstärke zu regeln. Eine Änderung der Streamlautstärke löst keine UI auf dem Empfänger aus.
| Name | Typ | Beschreibung |
|---|---|---|
| mediaSessionId | Ganzzahl | Mediensitzungs-ID der Medien, deren Streamlautstärke geändert wird |
| requestId | Ganzzahl | ID der Anfrage, um Anfrage und Antwort in Beziehung zu setzen |
| Typ | String | VOLUME (nur Wert) |
| Volume | Volume | Stream-Lautstärke |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Absenderanwendung definiert wird |
| Antwort | Trigger | Übertragungen | Fehler |
|---|---|---|---|
| Keine | Änderung des Empfängerstatus | Eine Nachricht zur Statusänderung von Medien | 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 vorliegt.
- 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 Senders nicht erfüllt werden kann, weil der Player keinen gültigen Status hat. Zum Beispiel, wenn die Anwendung noch kein Medienelement erstellt hat.
| Name | Typ | Beschreibung |
|---|---|---|
| requestId | Ganzzahl | ID der Anfrage, die diesen Fehler generiert hat |
| Typ | String | INVALID_PLAYER_STATE (nur Wert) |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Empfängeranwendung definiert wird |
Fehler: Laden fehlgeschlagen
Wird gesendet, wenn die Ladeanfrage fehlgeschlagen ist. Der Player-Status lautet INAKTIV.
| Name | Typ | Beschreibung |
|---|---|---|
| requestId | Ganzzahl | ID der Anfrage, die diesen Fehler generiert hat |
| Typ | String | LOAD_FAILED (nur Wert) |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, 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 | Ganzzahl | ID der Anfrage, die diesen Fehler generiert hat |
| Typ | String | LOAD_CANCELLED (nur Wert) |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, 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 | Ganzzahl | ID der Anfrage, die diesen Fehler generiert hat |
| Typ | String | INVALID_REQUEST (nur Wert) |
| Grund | Enum (String) | Werte:
|
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Empfängeranwendung definiert wird |
Medienstatus
Wird nach einer Statusänderung oder nach einer Medienstatusanfrage gesendet. Nur die MediaStatus-Objekte, die geändert wurden oder angefordert wurden, werden gesendet.
| Name | Typ | Beschreibung |
|---|---|---|
| requestId | Ganzzahl | ID, die verwendet wird, um diese Statusantwort mit der Anfrage zu korrelieren, von der sie stammt, oder 0, wenn die Statusnachricht spontan ist (nicht durch eine Absenderanfrage ausgelöst). Senderanwendungen erzeugen eindeutige Anfrage-IDs, indem sie eine Zufallszahl auswählen und diese kontinuierlich erhöhen (nicht 0). |
| Typ | String | MEDIA_STATUS (nur Wert) |
| Status | MediaStatus[] | Array von Medienstatusobjekten HINWEIS: Das Medienelement in MediaStatus wird nur zurückgegeben, wenn es geändert wurde. |
| customData | Objekt | Optional Anwendungsspezifisches Daten-Blob, das von der Empfängeranwendung definiert wird |