Aplikacje wysyłające Google Cast sterują odtwarzaniem na urządzeniu odbierającym, wysyłając do aplikacji odbierającej wiadomości w formacie JSON. Podobnie odbiorca odsyła wiadomości do nadawcy, również w formacie JSON. Mogą to być polecenia od nadawcy, które zmieniają stan odtwarzacza, odpowiedzi na te polecenia od odbiorcy lub struktury danych opisujące media dla aplikacji odbiorcy.
Zgodnie z Dodatkowymi warunkami usługi Google Cast SDK dla deweloperów aplikacja multimedialna Cast musi używać tych komunikatów zgodnie z definicją podaną w tym dokumencie, aby sterować odtwarzaniem multimediów na odbiorniku. Zapewnia to spójne wrażenia użytkownika w aplikacji multimedialnej na różnych platformach i gwarantuje, że aplikacja Cast będzie obsługiwać nowe i przyszłe przypadki użycia. Te struktury obsługują też w odpowiednich przypadkach dane niestandardowe, a aplikacja może definiować własne wiadomości dla poleceń nieobsługiwanych przez pakiet SDK.
Przestrzeń nazw komunikatów odtwarzania multimediów jest zdefiniowana jako urn:x-cast:com.google.cast.media.
Uwaga: wiadomości i struktury w tej specyfikacji mają domyślny maksymalny rozmiar określony przez maksymalny rozmiar wiadomości transportowej. Nie ma limitu dla poszczególnych pól. Maksymalny rozmiar wiadomości transportowej wynosi obecnie 64 KB.
Typowe struktury danych przestrzeni nazw
Nadbiór struktur danych używanych przez wszystkie artefakty przestrzeni nazw multimediów jest zdefiniowany w przestrzeni nazw wspólnych.
Obraz
Jest to opis obrazu, który zawiera niewielką ilość metadanych, aby aplikacja wysyłająca mogła wybrać obrazy w zależności od tego, jak będą renderowane.
Wysokość i szerokość są opcjonalne tylko w przypadku jednego elementu w tablicy obrazów. Jeśli na przykład zwracany jest 1 produkt, są one opcjonalne. Jeśli zwracane są 2 produkty, 1 z nich musi mieć określone wysokość i szerokość, ale nadawca może wybrać opcję „domyślna”, jeśli nie odpowiada mu ta przekazana z określonymi parametrami.
| Nazwa | Typ | Opis |
|---|---|---|
| url | Identyfikator URI | Identyfikator URI obrazu |
| height | liczba całkowita | opcjonalnie wysokość obrazu. |
| width | liczba całkowita | opcjonalnie Szerokość obrazu |
Głośność
Głośność strumienia multimediów. Służy do efektów zanikania i pojawiania się strumienia multimediów. (Uwaga: głośność systemu jest zmieniana za pomocą interfejsów API nadawcy). Głośności strumienia nie można używać w połączeniu z suwakiem głośności ani przyciskami głośności do sterowania głośnością urządzenia. Aby zmienić głośność strumienia, musisz przekazać co najmniej 1 z tych parametrów:
| Nazwa | Typ | Opis |
|---|---|---|
| level | podwójny | opcjonalnie Bieżący poziom głośności strumienia jako wartość z zakresu od 0,0 do 1,0, gdzie 1,0 to maksymalna głośność. |
| wyciszony | Wartość logiczna | opcjonalne : czy urządzenie Cast jest wyciszone, niezależnie od poziomu głośności. |
Struktury danych przestrzeni nazw multimediów
Te wiadomości opisują stan odtwarzacza multimediów. Przestrzeń nazw to urn:x-cast:com.google.cast.media.
MediaInformation
Ta struktura danych opisuje strumień multimediów.
| Nazwa | Typ | Opis |
|---|---|---|
| contentId | ciąg znaków | Identyfikator treści wczytanych obecnie przez odtwarzacz multimediów, który jest specyficzny dla danej usługi. Jest to ciąg znaków w dowolnym formacie, który jest specyficzny dla aplikacji. W większości przypadków będzie to adres URL do multimediów, ale nadawca może przekazać ciąg znaków, który odbiorca będzie mógł prawidłowo zinterpretować. Maksymalna długość: 1 tys. |
| streamType | enum (string) |
Opisuje typ artefaktu multimedialnego jako jeden z tych typów:
|
| contentType | ciąg znaków | Typ MIME odtwarzanych multimediów. |
| metadane | obiekt | opcjonalny obiekt metadanych multimediów, jeden z tych typów: |
| duration | podwójny | opcjonalny Czas trwania aktualnie odtwarzanego strumienia w sekundach |
| customData | obiekt | opcjonalny blob danych specyficzny dla aplikacji, zdefiniowany przez aplikację nadawcy lub odbiorcy. |
GenericMediaMetadata
Opisuje ogólny artefakt multimedialny.
| Nazwa | Typ | Opis |
|---|---|---|
| metadataType | liczba całkowita | 0 (jedyna wartość) |
| title | ciąg znaków | opcjonalny Opisowy tytuł treści. Odtwarzacz może samodzielnie pobrać tytuł za pomocą parametru content_id lub może go otrzymać od nadawcy w wiadomości Load. |
| subtitle | ciąg znaków | opcjonalny Opisowy podtytuł treści. Odtwarzacz może samodzielnie pobrać tytuł za pomocą parametru content_id lub może go otrzymać od nadawcy w wiadomości Load. |
| obrazów | Image[] | opcjonalny tablica adresów URL obrazów powiązanych z treścią. Początkową wartość pola może podać nadawca w wiadomości Load. Powinny zawierać zalecane rozmiary |
| releaseDate | ciąg znaków (ISO 8601) | opcjonalna data i godzina wydania tych treści w formacie ISO 8601. Odtwarzacz może samodzielnie pobrać tytuł za pomocą parametru content_id lub może go otrzymać od nadawcy w wiadomości Load. |
MovieMediaMetadata
Opisuje artefakt multimedialny filmu.
| Nazwa | Typ | Opis |
|---|---|---|
| metadataType | liczba całkowita | 1 (jedyna wartość) |
| title | ciąg znaków | opcjonalny Opisowy tytuł treści. Odtwarzacz może samodzielnie pobrać tytuł za pomocą parametru content_id lub może go otrzymać od nadawcy w wiadomości Load. |
| subtitle | ciąg znaków | opcjonalny Opisowy podtytuł treści. Odtwarzacz może samodzielnie pobrać tytuł za pomocą parametru content_id lub może go otrzymać od nadawcy w wiadomości Load. |
| studio | ciąg znaków | opcjonalnie studio, które opublikowało treści. Odtwarzacz może samodzielnie pobrać studio za pomocą identyfikatora content_id lub może go podać nadawca w wiadomości Load. |
| obrazów | Image[] | opcjonalny tablica adresów URL obrazów powiązanych z treścią. Początkową wartość pola może podać nadawca w wiadomości Load. Powinny zawierać zalecane rozmiary |
| releaseDate | ciąg znaków (ISO 8601) | opcjonalna data i godzina wydania tych treści w formacie ISO 8601. Odtwarzacz może samodzielnie pobrać tytuł za pomocą parametru content_id lub może go otrzymać od nadawcy w wiadomości Load. |
TvShowMediaMetadata
Opisuje artefakt multimedialny odcinka programu telewizyjnego.
| Nazwa | Typ | Opis |
|---|---|---|
| metadataType | liczba całkowita | 2 (jedyna wartość) |
| seriesTitle | ciąg znaków | opcjonalny Opisowy tytuł serialu. Odtwarzacz może samodzielnie pobrać tytuł za pomocą parametru content_id lub może go otrzymać od nadawcy w wiadomości Load. |
| subtitle | ciąg znaków | opcjonalny Podtytuł odcinka serialu. Odtwarzacz może samodzielnie pobrać tytuł za pomocą parametru content_id lub może go otrzymać od nadawcy w wiadomości Load. |
| sezon | liczba całkowita | opcjonalnie Numer sezonu serialu telewizyjnego. |
| odcinek | liczba całkowita | opcjonalny numer odcinka (w sezonie) programu telewizyjnego |
| obrazów | Image[] | opcjonalny tablica adresów URL obrazów powiązanych z treścią. Początkową wartość pola może podać nadawca w wiadomości Load. Powinny zawierać zalecane rozmiary |
| originalAirDate | ciąg znaków (ISO 8601) | opcjonalnie data i godzina wydania odcinka w formacie ISO 8601. Odtwarzacz może samodzielnie pobrać oryginalną datę emisji za pomocą identyfikatora content_id lub może ją otrzymać od nadawcy w wiadomości Load. |
MusicTrackMediaMetadata
Opisuje artefakt multimedialny utworu muzycznego.
| Nazwa | Typ | Opis |
|---|---|---|
| metadataType | liczba całkowita | 3 (jedyna wartość) |
| albumName | ciąg znaków | opcjonalny Album lub kolekcja, z której pochodzi ten utwór. Odtwarzacz może samodzielnie pobrać nazwę albumu za pomocą identyfikatora content_id lub może ją podać nadawca w wiadomości Load. |
| title | ciąg znaków | opcjonalnie Nazwa utworu (np. tytuł piosenki). Odtwarzacz może samodzielnie pobrać tytuł za pomocą parametru content_id lub może go otrzymać od nadawcy w wiadomości Load. |
| albumArtist | ciąg znaków | opcjonalnie Nazwa wykonawcy powiązanego z albumem, na którym znajduje się ten utwór. Odtwarzacz może samodzielnie pobrać albumArtist za pomocą content_id lub może zostać podany przez nadawcę w wiadomości Load. |
| wykonawca | ciąg znaków | opcjonalne Nazwa wykonawcy powiązanego ze ścieżką multimedialną. Odtwarzacz może samodzielnie pobrać wykonawcę za pomocą identyfikatora content_id lub może go podać nadawca w wiadomości Load. |
| composer | ciąg znaków | opcjonalne Nazwa kompozytora powiązanego ze ścieżką multimedialną. Odtwarzacz może samodzielnie pobrać kompozytora za pomocą identyfikatora content_id lub może go podać nadawca w wiadomości Load. |
| trackNumber | liczba całkowita | opcjonalny numer utworu na albumie |
| discNumber | liczba całkowita | opcjonalnie numer woluminu (np. płyty) albumu. |
| obrazów | Image[] | opcjonalny tablica adresów URL obrazów powiązanych z treścią. Początkową wartość pola może podać nadawca w wiadomości Load. Powinny zawierać zalecane rozmiary |
| releaseDate | ciąg znaków (ISO 8601) | opcjonalna data i godzina wydania tych treści w formacie ISO 8601. Odtwarzacz może samodzielnie pobrać datę premiery za pomocą identyfikatora content_id lub może ją podać nadawca w wiadomości Load. |
PhotoMediaMetadata
Opisuje artefakt związany z nośnikiem fotograficznym.
| Nazwa | Typ | Opis |
|---|---|---|
| metadataType | liczba całkowita | 4 (jedyna wartość) |
| title | ciąg znaków | opcjonalnie Tytuł zdjęcia. Odtwarzacz może samodzielnie pobrać tytuł za pomocą parametru content_id lub może go otrzymać od nadawcy w wiadomości Load. |
| wykonawca | ciąg znaków | opcjonalnie Nazwa fotografa. Odtwarzacz może samodzielnie pobrać wykonawcę za pomocą identyfikatora content_id lub może go podać nadawca w wiadomości Load. |
| lokalizacja | ciąg znaków | opcjonalne : słowna lokalizacja, w której zostało zrobione zdjęcie, np. „Madryt, Hiszpania”. Odtwarzacz może samodzielnie pobrać lokalizację za pomocą parametru content_id lub może ją podać nadawca w wiadomości Load. |
| latitude | podwójny | opcjonalnie Wartość szerokości geograficznej miejsca, w którym zostało zrobione zdjęcie. Odtwarzacz może samodzielnie pobrać szerokość geograficzną za pomocą parametru content_id lub może ją podać nadawca w wiadomości Load. |
| longitude | podwójny | opcjonalnie Wartość długości geograficznej lokalizacji, w której zrobiono zdjęcie. Odtwarzacz może samodzielnie pobrać długość geograficzną za pomocą parametru content_id lub może ją podać nadawca w wiadomości Load. |
| width | liczba całkowita | opcjonalny Szerokość zdjęcia w pikselach. Odtwarzacz może samodzielnie pobrać szerokość za pomocą parametru content_id lub może ją podać nadawca w wiadomości Load. |
| height | liczba całkowita | opcjonalny Wysokość zdjęcia w pikselach. Odtwarzacz może samodzielnie pobrać wysokość za pomocą parametru content_id lub może ją podać nadawca w wiadomości Load. |
| creationDateTime | ciąg znaków (ISO 8601) | opcjonalna data i godzina wykonania zdjęcia w formacie ISO 8601. Odtwarzacz może samodzielnie pobrać wartość creationDateTime za pomocą parametru content_id lub może ją otrzymać od nadawcy w wiadomości Load. |
MediaStatus
Opisuje bieżący stan artefaktu multimedialnego w odniesieniu do sesji.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | liczba całkowita | Unikalny identyfikator odtwarzania tej konkretnej sesji. Ten identyfikator jest ustawiany przez odbiorcę podczas wczytywania i może służyć do identyfikowania konkretnego wystąpienia odtwarzania. Na przykład 2 odtwarzania utworu „Wish you were here” w ramach tej samej sesji będą miały unikalne identyfikatory mediaSessionId. |
| media | MediaInformation | opcjonalny (w przypadku wiadomości o stanie) Pełny opis odtwarzanych treści. Będzie zwracany w wiadomościach o stanie tylko wtedy, gdy zmienią się informacje o multimediach. |
| playbackRate | liczba zmiennoprzecinkowa | Wskazuje, czy czas odtwarzania multimediów się zmienia i w jakim tempie. Jest to niezależne od stanu odtwarzacza, ponieważ czas odtwarzania multimediów może się zatrzymać w dowolnym stanie. 1,0 to normalny czas, a 0,5 to zwolnione tempo. |
| playerState | enum (string) | Opisuje stan odtwarzacza jako jedną z tych wartości:
|
| idleReason | enum (string) | opcjonalna : jeśli stan odtwarzacza to IDLE i znana jest przyczyna przejścia do tego stanu, ta właściwość jest podawana. Jeśli odtwarzacz jest w stanie IDLE, ponieważ dopiero się uruchomił, ta właściwość nie zostanie podana. Jeśli odtwarzacz jest w innym stanie, ta właściwość nie powinna być podana. Obowiązują te wartości:
|
| currentTime | podwójny | Bieżąca pozycja odtwarzacza multimediów od początku treści (w sekundach). Jeśli są to treści transmisji na żywo, to pole reprezentuje czas w sekundach od początku wydarzenia, który powinien być znany odtwarzaczowi. |
| supportedMediaCommands | flagi | Flagi opisujące, które polecenia multimedialne obsługuje odtwarzacz multimediów:
Kombinacje są opisywane jako sumy, np. Pause+Seek+StreamVolume+Mute == 15. |
| volume | Głośność | Głośność transmisji |
| customData | obiekt | opcjonalne : blob danych specyficzny dla aplikacji, zdefiniowany przez aplikację odbiorcy. |
Polecenia od nadawcy do odbiorcy
Te polecenia sterują odtwarzaczem multimediów. Wszystkie obiekty customData w poniższych wiadomościach muszą być opcjonalne (tzn. odbiorca powinien prawidłowo reagować, jeśli dane nie zostaną przekazane). Dzięki temu ogólne aplikacje do zdalnego sterowania będą działać prawidłowo.
Wczytaj
Wczytuje nowe treści do odtwarzacza.
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | liczba całkowita | Identyfikator żądania, który umożliwia powiązanie żądania z odpowiedzią. |
| type | ciąg znaków | LOAD (tylko wartość) |
| media | MediaInformation | Metadane (w tym contentId) multimediów do wczytania |
| autoplay | Wartość logiczna | opcjonalny (domyślnie „true”). Jeśli określono parametr autoodtwarzania, odtwarzacz multimediów rozpocznie odtwarzanie treści po ich załadowaniu. Nawet jeśli autoodtwarzanie nie jest określone, implementacja odtwarzacza multimediów może rozpocząć odtwarzanie od razu. Jeśli odtwarzanie się rozpoczęło, stan odtwarzacza w odpowiedzi powinien mieć wartość BUFFERING, w przeciwnym razie powinien mieć wartość PAUSED. |
| currentTime | podwójny | opcjonalnie sekundy od początku treści. Jeśli treści są transmitowane na żywo, a pozycja nie jest określona, strumień rozpocznie się w momencie rozpoczęcia nadawania na żywo. |
| customData | obiekt | opcjonalne : blob danych specyficznych dla aplikacji zdefiniowany przez aplikację wysyłającą. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Brak | Zmiana stanu odbiornika | Komunikat o zmianie stanu multimediów | Nieprawidłowy stan odtwarzacza Nie udało się załadować Anulowano ładowanie |
Wstrzymaj
Wstrzymuje odtwarzanie bieżących treści. Wysyła powiadomienie o zdarzeniu STATUS do wszystkich aplikacji nadawcy.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | liczba całkowita | Identyfikator sesji multimedialnej, która ma zostać wstrzymana |
| requestId | liczba całkowita | Identyfikator żądania używany do korelacji żądania i odpowiedzi. |
| type | ciąg znaków | WSTRZYMAJ (tylko wartość) |
| customData | obiekt | opcjonalne : blob danych specyficznych dla aplikacji zdefiniowany przez aplikację wysyłającą. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Brak | Zmiana stanu odbiornika | Komunikat o zmianie stanu multimediów | Nieprawidłowy stan odtwarzacza |
Szukaj
Ustawia bieżącą pozycję w strumieniu. Wysyła powiadomienie o zdarzeniu STATUS do wszystkich aplikacji nadawcy. Jeśli podana pozycja wykracza poza zakres prawidłowych pozycji dla bieżących treści, odtwarzacz powinien wybrać prawidłową pozycję jak najbliższą żądanej.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | liczba całkowita | Identyfikator sesji multimedialnej, w której ustawiono pozycję strumienia |
| requestId | liczba całkowita | Identyfikator żądania, który umożliwia powiązanie żądania z odpowiedzią. |
| type | ciąg znaków | SEEK (tylko wartość) |
| resumeState | enum (string) | opcjonalny – jeśli ta wartość nie jest ustawiona, stan odtwarzania nie ulegnie zmianie. Obowiązują te wartości:
|
| currentTime | podwójny | opcjonalnie sekundy od początku treści. Jeśli treści są transmitowane na żywo, a pozycja nie jest określona, strumień rozpocznie się w momencie rozpoczęcia nadawania na żywo. |
| customData | obiekt | opcjonalne : blob danych specyficznych dla aplikacji zdefiniowany przez aplikację wysyłającą. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Brak | Zmiana stanu odbiornika | Komunikat o zmianie stanu multimediów | Nieprawidłowy stan odtwarzacza |
Zatrzymaj
Zatrzymuje odtwarzanie bieżących treści. Wysyła powiadomienie o zdarzeniu STATUS do wszystkich aplikacji nadawcy. Po wykonaniu tego polecenia treści nie będą już wczytywane, a identyfikator mediaSessionId zostanie unieważniony.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | liczba całkowita | Identyfikator sesji multimedialnej, w której ma zostać zatrzymane odtwarzanie treści. |
| requestId | liczba całkowita | Identyfikator żądania, który umożliwia powiązanie żądania z odpowiedzią. |
| type | ciąg znaków | STOP (tylko wartość) |
| customData | obiekt | opcjonalne : blob danych specyficznych dla aplikacji zdefiniowany przez aplikację wysyłającą. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Brak | Zmiana stanu odbiornika | Komunikat o zmianie stanu multimediów | Nieprawidłowy stan odtwarzacza |
Odtwórz
Rozpoczyna odtwarzanie treści, które zostały wczytane za pomocą wywołania load. Odtwarzanie jest kontynuowane od bieżącej pozycji czasowej.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | liczba całkowita | Identyfikator sesji multimedialnej dla treści, które mają być odtwarzane. |
| requestId | liczba całkowita | Identyfikator żądania, który umożliwia powiązanie żądania z odpowiedzią. |
| type | ciąg znaków | PLAY (tylko wartość) |
| customData | obiekt | opcjonalne : blob danych specyficznych dla aplikacji zdefiniowany przez aplikację wysyłającą. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Brak | Zmiana stanu odbiornika | Komunikat o zmianie stanu multimediów | Nieprawidłowy stan odtwarzacza |
Sprawdź stan
Pobiera stan multimediów.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | liczba całkowita | opcjonalny Identyfikator sesji multimedialnej, dla której ma zostać zwrócony stan. Jeśli nie podasz żadnego identyfikatora, otrzymasz stan wszystkich identyfikatorów sesji multimedialnych. |
| requestId | liczba całkowita | Identyfikator żądania, który umożliwia powiązanie żądania z odpowiedzią. |
| type | ciąg znaków | GET_STATUS (jedyna wartość) |
| customData | obiekt | opcjonalne : blob danych specyficznych dla aplikacji zdefiniowany przez aplikację wysyłającą. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Wiadomość MediaStatus do nadawcy, który o nią poprosił. | Brak | Brak | Brak |
SetVolume
Ustawia głośność strumienia multimediów. Służy do efektów zanikania i pojawiania się strumienia multimediów. (Uwaga: głośność odbiornika jest zmieniana za pomocą funkcji setVolume nadawcy internetowego). Głośności strumienia nie można używać w połączeniu z suwakiem głośności ani przyciskami głośności do sterowania głośnością urządzenia. Zmiana głośności strumienia nie spowoduje wyświetlenia żadnego interfejsu na odbiorniku.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | liczba całkowita | Identyfikator sesji multimediów, dla których zmieniana jest głośność strumienia |
| requestId | liczba całkowita | Identyfikator żądania, który umożliwia powiązanie żądania z odpowiedzią. |
| type | ciąg znaków | VOLUME (tylko wartość) |
| volume | Głośność | Głośność transmisji |
| customData | obiekt | opcjonalne : blob danych specyficznych dla aplikacji zdefiniowany przez aplikację wysyłającą. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Brak | Zmiana stanu odbiornika | Komunikat o zmianie stanu multimediów | Nieprawidłowy stan odtwarzacza |
Wiadomości od odbiorcy do nadawcy
Odbiorca wysyła 2 rodzaje wiadomości:
- Błędy: wiadomości typu unicast wysyłane w przypadku odpowiedzi o błędzie na żądanie nadawcy.
- Stan: wysyłanie komunikatów.
- Konsekwencja działania zainicjowanego przez nadawcę. Zawiera identyfikator żądania, które spowodowało zmianę.
- Spontaniczne: na przykład z powodu zmiany wywołanej przez aplikację odbiorczą. Identyfikator RequestId będzie wynosić 0.
Błąd: nieprawidłowy stan odtwarzacza
Wysyłany, gdy żądanie nadawcy nie może zostać zrealizowane, ponieważ odtwarzacz jest w nieprawidłowym stanie. Na przykład jeśli aplikacja nie utworzyła jeszcze elementu multimedialnego.
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | liczba całkowita | Identyfikator żądania, które wygenerowało ten błąd |
| type | ciąg znaków | INVALID_PLAYER_STATE (tylko ta wartość) |
| customData | obiekt | opcjonalne : blob danych specyficzny dla aplikacji, zdefiniowany przez aplikację odbiorcy. |
Błąd: nie udało się załadować
Wysyłane, gdy nie udało się wczytać. Stan odtwarzacza będzie IDLE.
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | liczba całkowita | Identyfikator żądania, które wygenerowało ten błąd |
| type | ciąg znaków | LOAD_FAILED (tylko wartość) |
| customData | obiekt | opcjonalne : blob danych specyficzny dla aplikacji, zdefiniowany przez aplikację odbiorcy. |
Błąd: wczytywanie anulowane
Wysłany, gdy prośba o wczytanie została anulowana (otrzymano drugą prośbę o wczytanie).
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | liczba całkowita | Identyfikator żądania, które wygenerowało ten błąd |
| type | ciąg znaków | LOAD_CANCELLED (jedyna wartość) |
| customData | obiekt | opcjonalne : blob danych specyficzny dla aplikacji, zdefiniowany przez aplikację odbiorcy. |
Błąd: nieprawidłowe żądanie
Wysyłany, gdy żądanie jest nieprawidłowe (np. nieznany typ żądania).
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | liczba całkowita | Identyfikator żądania, które wygenerowało ten błąd |
| type | ciąg znaków | INVALID_REQUEST (tylko wartość) |
| przyczyna | Wyliczenie (ciąg) | Wartości:
|
| customData | obiekt | opcjonalne : blob danych specyficzny dla aplikacji, zdefiniowany przez aplikację odbiorcy. |
Stan multimediów
Wysyłany po zmianie stanu lub po wysłaniu prośby o stan multimediów. Wysłane zostaną tylko obiekty MediaStatus, które uległy zmianie lub zostały zażądane.
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | liczba całkowita | Identyfikator używany do powiązania tej odpowiedzi o stanie z żądaniem, które ją wywołało, lub 0, jeśli wiadomość o stanie jest spontaniczna (nie została wywołana przez żądanie nadawcy). Aplikacje nadawcze będą generować unikalne identyfikatory żądań, wybierając losową liczbę i stale ją zwiększając (nie będą używać zera). |
| type | ciąg znaków | MEDIA_STATUS (jedyna wartość) |
| stan | MediaStatus[] | Tablica obiektów stanu multimediów. UWAGA: element multimedialny w obiekcie MediaStatus zostanie zwrócony tylko wtedy, gdy ulegnie zmianie. |
| customData | obiekt | opcjonalne : blob danych specyficzny dla aplikacji, zdefiniowany przez aplikację odbiorcy. |