Aplikacje nadawcy Google Cast kontrolują odtwarzanie na urządzeniu odbierającym, wysyłając wiadomości w formacie JSON do aplikacji odbierającej. Podobnie odbiorca wysyła wiadomości z powrotem do nadawcy, także w formacie JSON. Wiadomości mogą być poleceniami nadawcy, które zmieniają stan odtwarzacza, odpowiedziami na te polecenia z odbiorcy lub strukturami danych opisującymi multimedia w aplikacji odbierającej.
Zgodnie z Dodatkowymi warunkami korzystania z pakietu SDK Google Cast dla deweloperów aplikacja Cast musi używać tych komunikatów, aby sterować odtwarzaniem multimediów na odbiorniku. Dzięki temu aplikacja do multimediów będzie działać w spójny sposób na różnych platformach, a aplikacja przesyłająca będzie obsługiwać nowe i przyszłe przypadki użycia. W razie potrzeby te struktury obsługują też dane niestandardowe, a aplikacja może definiować własne komunikaty dla poleceń nieobsługiwanych przez pakiet SDK.
Przestrzeń nazw wiadomości dotyczących odtwarzania multimediów jest zdefiniowana jako urn:x-cast:com.google.cast.media.
Uwaga: wiadomości i struktury opisane w tej specyfikacji mają maksymalny rozmiar określony na podstawie maksymalnego rozmiaru wiadomości transportowej. Nie ma limitu dla poszczególnych pól. Maksymalny rozmiar wiadomości transportowej wynosi obecnie 64 KB.
Wspólne struktury danych przestrzeni nazw
Nadzbiór struktur danych używanych przez wszystkie artefakty przestrzeni nazw multimediów jest zdefiniowany we wspólnej przestrzeni nazw.
Obraz
Jest to opis obrazu zawierający niewielką ilość metadanych, dzięki którym nadawca będzie mógł wybrać obrazy w zależności od tego, jak zostaną wyrenderowane.
Wysokość i szerokość są opcjonalne tylko w jednym elemencie w tablicy Obrazy. Jeśli na przykład zwracany jest jeden element, są one opcjonalne. W przypadku dwóch zwróconych elementów każdy z nich musi określić wysokość i szerokość. Nadawca może jednak wybrać opcję „default” (domyślnie), jeśli nie odpowiada temu elementowi przekazanemu z określonymi parametrami.
| Nazwa | Typ | Opis |
|---|---|---|
| adres URL | Identyfikator URI | Identyfikator URI obrazu |
| height, | Liczba całkowita | optional – wysokość obrazu. |
| width | Liczba całkowita | optional – szerokość obrazu. |
Głośność
Głośność strumienia multimediów. Służy do obsługi efektów w strumieniu multimediów. (Uwaga: głośność systemu zmienia się za pomocą interfejsów API nadawcy). Głośność transmisji nie może być używana w połączeniu z suwakiem głośności lub przyciskami głośności do regulacji głośności urządzenia. Aby zmienić głośność strumienia, musisz przekazać co najmniej jeden z tych parametrów.
| Nazwa | Typ | Opis |
|---|---|---|
| poziom | liczba zmiennoprzecinkowa | opcjonalnie – bieżący poziom głośności strumienia musi mieścić się w przedziale od 0,0 do 1,0, gdzie 1,0 to maksymalna głośność; |
| wyciszone | boolean | opcjonalnie – określa, czy urządzenie przesyłające jest wyciszone (niezależnie od poziomu głośności). |
Struktury danych przestrzeni nazw multimediów
Te komunikaty opisują stan odtwarzacza. 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 | Zgodny z usługą identyfikator treści aktualnie załadowanych przez odtwarzacz. Jest to dowolny ciąg znaków, który jest specyficzny dla danej aplikacji. W większości przypadków jest to adres URL multimediów, ale nadawca może zdecydować, że przekaże ciąg, który odbiorca będzie mógł prawidłowo zinterpretować. Maks. długość: 1 tys. |
| streamType | wyliczenie (ciąg znaków) |
Opisuje typ artefaktu multimedialnego jako jeden z następujących opisów:
|
| contentType | ciąg znaków | Typ MIME odtwarzanych multimediów |
| metadane | obiekt | optional obiekt metadanych multimediów (jeden z tych rodzajów): |
| duration (czas trwania) | liczba zmiennoprzecinkowa | opcjonalnie – czas trwania aktualnie odtwarzanej transmisji w sekundach. |
| customData | obiekt | opcjonalny – obiekt blob aplikacji zdefiniowany przez aplikację nadawcy lub aplikację odbiorcy. |
GenericMediaMetadata
Opisuje ogólny artefakt multimediów.
| Nazwa | Typ | Opis |
|---|---|---|
| metadataType | Liczba całkowita | 0 (jedyna wartość) |
| title | ciąg znaków | opcjonalny – opisowy tytuł treści. Odtwarzacz może pobierać tytuł niezależnie za pomocą parametru content_id lub może on otrzymać go od nadawcy w wiadomości Load (Wczytaj). |
| napisy | ciąg znaków | opcjonalny – opisowy podtytuł treści. Odtwarzacz może pobierać tytuł niezależnie za pomocą parametru content_id lub może on otrzymać go od nadawcy w wiadomości Load (Wczytaj). |
| obrazy | Obraz[] | Opcjonalne: Tablica adresów URL obrazu powiązanego z treścią. Początkową wartość tego pola może podać nadawca w wiadomości Load (Wczytaj). Należy podać zalecane rozmiary |
| releaseDate | ciąg znaków (ISO 8601) | opcjonalnie – data i godzina w formacie ISO 8601, Odtwarzacz może pobierać tytuł niezależnie za pomocą parametru content_id lub może on otrzymać go od nadawcy w wiadomości Load (Wczytaj). |
MovieMediaMetadata
Opisuje materiał multimedialny.
| Nazwa | Typ | Opis |
|---|---|---|
| metadataType | Liczba całkowita | 1 (jedyna wartość) |
| title | ciąg znaków | opcjonalny – opisowy tytuł treści. Odtwarzacz może pobierać tytuł niezależnie za pomocą parametru content_id lub może on otrzymać go od nadawcy w wiadomości Load (Wczytaj). |
| napisy | ciąg znaków | opcjonalny – opisowy podtytuł treści. Odtwarzacz może pobierać tytuł niezależnie za pomocą parametru content_id lub może on otrzymać go od nadawcy w wiadomości Load (Wczytaj). |
| studio | ciąg znaków | opcjonalnie Studio, w którym opublikowano treści. Odtwarzacz może niezależnie pobrać studio, korzystając z parametru content_id, lub może on otrzymać od nadawcy w wiadomości Load (Wczytaj). |
| obrazy | Obraz[] | Opcjonalne: Tablica adresów URL obrazu powiązanego z treścią. Początkową wartość tego pola może podać nadawca w wiadomości Load (Wczytaj). Należy podać zalecane rozmiary |
| releaseDate | ciąg znaków (ISO 8601) | opcjonalnie – data i godzina w formacie ISO 8601, Odtwarzacz może pobierać tytuł niezależnie za pomocą parametru content_id lub może on otrzymać go od nadawcy w wiadomości Load (Wczytaj). |
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ł serii filmów. Odtwarzacz może pobierać tytuł niezależnie za pomocą parametru content_id lub może on otrzymać go od nadawcy w wiadomości Load (Wczytaj). |
| napisy | ciąg znaków | Opcjonalnie: opisowy podtytuł odcinka serialu telewizyjnego. Odtwarzacz może pobierać tytuł niezależnie za pomocą parametru content_id lub może on otrzymać go od nadawcy w wiadomości Load (Wczytaj). |
| sezon | Liczba całkowita | optional : numer sezonu programu telewizyjnego. |
| episode | Liczba całkowita | opcjonalny Numer odcinka (w sezonie) programu telewizyjnego. |
| obrazy | Obraz[] | Opcjonalne: Tablica adresów URL obrazu powiązanego z treścią. Początkową wartość tego pola może podać nadawca w wiadomości Load (Wczytaj). Należy podać zalecane rozmiary |
| originalAirDate | ciąg znaków (ISO 8601) | Opcjonalne – data i godzina publikacji tego odcinka w formacie ISO 8601. Odtwarzacz może niezależnie pobrać datę originAirDate za pomocą parametru content_id lub nadawca może ją otrzymać w wiadomości Load (Wczytaj). |
MusicTrackMediaMetadata
Opisuje artefakt multimedialny utworu muzycznego.
| Nazwa | Typ | Opis |
|---|---|---|
| metadataType | Liczba całkowita | 3 (jedyna wartość) |
| albumName | ciąg znaków | optional : album lub kolekcja, z których został pobrany ten utwór. Odtwarzacz może niezależnie pobierać albumAlbumName za pomocą parametru content_id lub może on otrzymać od nadawcy w wiadomości Load (Wczytaj). |
| title | ciąg znaków | Opcjonalne – nazwa utworu (np. tytuł utworu). Odtwarzacz może pobierać tytuł niezależnie za pomocą parametru content_id lub może on otrzymać go od nadawcy w wiadomości Load (Wczytaj). |
| albumArtist | ciąg znaków | optional – nazwa wykonawcy powiązanego z albumem zawierającym ten utwór. Odtwarzacz może niezależnie pobierać albumAlbumArtist za pomocą parametru content_id lub może on zostać podany przez nadawcę w wiadomości Wczytaj |
| wykonawca | ciąg znaków | optional – nazwa wykonawcy powiązanego ze utworem multimedialnym. Odtwarzacz może niezależnie pobierać wykonawcę za pomocą parametru content_id lub nadawcy w wiadomości Wczytaj. |
| kompozytor | ciąg znaków | Opcjonalne – nazwa kompozytora powiązanego ze ścieżką multimediów. Odtwarzacz może niezależnie pobierać informacje o kompozytorze, korzystając z parametru content_id, lub może go otrzymać nadawca w wiadomości Load (Wczytaj) |
| trackNumber | Liczba całkowita | optional Numer utworu na albumie. |
| discNumber | Liczba całkowita | optional Numer woluminu (na przykład dysku) albumu |
| obrazy | Obraz[] | Opcjonalne: Tablica adresów URL obrazu powiązanego z treścią. Początkową wartość tego pola może podać nadawca w wiadomości Load (Wczytaj). Należy podać zalecane rozmiary |
| releaseDate | ciąg znaków (ISO 8601) | opcjonalnie – data i godzina w formacie ISO 8601, Odtwarzacz może niezależnie pobrać datę wydania, korzystając z parametru content_id, lub może ją otrzymać nadawca w wiadomości Load (Ładowanie). |
PhotoMediaMetadata
Opisuje fotograficzny artefakt multimedialny.
| Nazwa | Typ | Opis |
|---|---|---|
| metadataType | Liczba całkowita | 4 (jedyna wartość) |
| title | ciąg znaków | opcjonalny – tytuł zdjęcia. Odtwarzacz może pobierać tytuł niezależnie za pomocą parametru content_id lub może on otrzymać go od nadawcy w wiadomości Load (Wczytaj). |
| wykonawca | ciąg znaków | optional imię i nazwisko fotografa. Odtwarzacz może niezależnie pobierać wykonawcę za pomocą parametru content_id lub nadawcy w wiadomości Wczytaj. |
| lokalizacja | ciąg znaków | optional słowne miejsce wykonania zdjęcia, na przykład „Madryt, Hiszpania”. Odtwarzacz może niezależnie pobierać lokalizację, korzystając z parametru content_id lub może ją otrzymać nadawca w wiadomości Load (Wczytaj) |
| latitude | liczba zmiennoprzecinkowa | opcjonalnie – szerokość geograficzna lokalizacji, w której zrobiono zdjęcie. Odtwarzacz może niezależnie pobierać szerokość geograficzną za pomocą parametru content_id lub może ją otrzymać nadawca w wiadomości Load (Wczytaj). |
| longitude | liczba zmiennoprzecinkowa | optional długość geograficzna lokalizacji, w której zrobiono zdjęcie. Odtwarzacz może niezależnie pobierać długość geograficzną za pomocą parametru content_id lub można ją podać przez nadawcę w wiadomości Wczytaj. |
| width | Liczba całkowita | optional – szerokość zdjęcia w pikselach. Odtwarzacz może niezależnie pobierać szerokość za pomocą parametru content_id lub można ją określić przez nadawcę w wiadomości Load (Wczytaj). |
| height, | Liczba całkowita | optional – wysokość zdjęcia w pikselach. Odtwarzacz może pobierać wysokość niezależnie za pomocą parametru content_id lub może ją otrzymać nadawca w wiadomości Load (Wczytaj). |
| creationDateTime | ciąg znaków (ISO 8601) | opcjonalnie – data i godzina wykonania zdjęcia w formacie ISO 8601. Odtwarzacz może niezależnie pobierać plik createDateTime za pomocą parametru content_id lub może on zostać podany przez nadawcę w wiadomości Load (Ładowanie). |
MediaStatus
Opisuje bieżący stan artefaktu multimedialnego w odniesieniu do sesji.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | Liczba całkowita | Unikalny identyfikator odtworzenia tej konkretnej sesji. Ten identyfikator jest ustawiany przez odbiornik podczas wczytywania i może służyć do identyfikowania konkretnego wystąpienia odtwarzania. Na przykład 2 odtworzenia filmu „Szkoda, że Cię tu” podczas tej samej sesji miałyby każdemu z nich unikalny identyfikator mediaSessionId. |
| media | MediaInformation | Opcjonalne (w przypadku komunikatów o stanie) Pełny opis odtwarzanej treści. Jest zwracana w komunikatach o stanie tylko wtedy, gdy wartość MediaInformation uległa zmianie. |
| playbackRate | float | Wskazuje, czy czas multimediów upływa i w jakim tempie. Nie zależy to od stanu odtwarzacza, ponieważ czas odtwarzania multimediów może się zatrzymać w dowolnym stanie. 1,0 to zwykły czas, 0,5 to zwolnione tempo |
| playerState | enum (ciąg znaków) | Opisuje stan odtwarzacza jako jeden z tych opisów:
|
| idleReason | enum (ciąg znaków) | optional tę właściwość, która jest podawana, jeśli parametr PlayerState ma wartość IDLE (nieaktywny) i powód jego stanu jest znany. Jeśli odtwarzacz jest nieaktywny, ponieważ właśnie się rozpoczął, ta właściwość nie zostanie podana. Jeśli odtwarzacz jest w innym stanie, nie należy podawać tej właściwości. Stosowane są te wartości:
|
| currentTime | liczba zmiennoprzecinkowa | Bieżąca pozycja odtwarzacza multimediów od początku treści (w sekundach). W przypadku treści transmisji na żywo to pole wskazuje wyrażony w sekundach czas od rozpoczęcia zdarzenia, który powinien być znany odtwarzaczowi. |
| supportedMediaCommands | flagi | Flagi opisujące polecenia multimediów obsługiwane przez odtwarzacz:
Kombinacje są opisane jako sumy, na przykład Pause+Seek+StreamVolume+Volume == 15. |
| ilość | Głośność | Głośność strumienia |
| customData | obiekt | opcjonalny : obiekt blob danych zdefiniowany przez aplikację odbierającą. |
Polecenia od nadawcy do odbiorcy
Te polecenia umożliwiają sterowanie odtwarzaczem. Wszystkie obiekty customData w poniższych komunikatach muszą być opcjonalne (tzn. odbiorca powinien się odpowiednio zepsuć, jeśli dane nie zostaną przekazane). Dzięki temu standardowe aplikacje pilota będą działać prawidłowo.
Wczytaj
Ładuje nowe treści do odtwarzacza.
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | Liczba całkowita | Identyfikator żądania, aby skorelować żądanie z odpowiedzią |
| type | ciąg znaków | LOAD (tylko wartość) |
| media | MediaInformation | Metadane (w tym contentId) multimediów do wczytania |
| autoodtwarzanie | boolean | optional (wartość domyślna): jeśli parametr autoodtwarzania jest określony, odtwarzacz rozpocznie odtwarzanie treści po jej wczytaniu. Nawet jeśli nie określisz funkcji autoodtwarzania, implementacja odtwarzacza multimediów może rozpocząć odtwarzanie od razu. Gdy odtwarzanie zostało rozpoczęte, stan odtwarzacza w odpowiedzi powinien być ustawiony na BUFFERING. W przeciwnym razie powinien mieć wartość WSTRZYMANE. |
| currentTime | liczba zmiennoprzecinkowa | optional : liczba sekund od rozpoczęcia treści. Jeśli treść to transmisja na żywo, a pozycja nie jest określona, transmisja rozpocznie się od miejsca na żywo. |
| customData | obiekt | opcjonalny – obiekt blob aplikacji zdefiniowany przez aplikację nadawcy. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Brak | Zmiana stanu odbiornika | Komunikat o zmianie stanu multimediów | Nieprawidłowy stan odtwarzacza Wczytywanie nie powiodło się Wczytywanie anulowane |
Wstrzymaj
Wstrzymuje odtwarzanie bieżącej treści. Wyzwala powiadomienie o zdarzeniu STATUS dla wszystkich aplikacji nadawców.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | Liczba całkowita | Identyfikator sesji multimediów, która ma zostać wstrzymana |
| requestId | Liczba całkowita | Identyfikator żądania używany do skorelowania żądania z odpowiedzią |
| type | ciąg znaków | PAUSE (tylko wartość) |
| customData | obiekt | opcjonalny – obiekt blob aplikacji zdefiniowany przez aplikację nadawcy. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Brak | Zmiana stanu odbiornika | Komunikat o zmianie stanu multimediów | Nieprawidłowy stan odtwarzacza |
Przewiń
Określa bieżącą pozycję w strumieniu. Wyzwala powiadomienie o zdarzeniu STATUS dla wszystkich aplikacji nadawców. Jeśli podana pozycja wykracza poza zakres prawidłowych pozycji dla bieżącej treści, odtwarzacz powinien wybrać prawidłową pozycję jak najbliżej żądanej pozycji.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | Liczba całkowita | Identyfikator sesji multimediów, w której ustawiana jest pozycja strumienia |
| requestId | Liczba całkowita | Identyfikator żądania, aby skorelować żądanie z odpowiedzią |
| type | ciąg znaków | SEEK (tylko wartość) |
| resumeState | enum (ciąg znaków) | Opcjonalne – jeśli ta wartość nie jest określona, stan odtwarzania się nie zmieni. Obowiązują te wartości:
|
| currentTime | liczba zmiennoprzecinkowa | optional : liczba sekund od rozpoczęcia treści. Jeśli treść to transmisja na żywo, a pozycja nie jest określona, transmisja rozpocznie się od miejsca na żywo. |
| customData | obiekt | opcjonalny – obiekt blob aplikacji zdefiniowany przez aplikację nadawcy. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Brak | Zmiana stanu odbiornika | Komunikat o zmianie stanu multimediów | Nieprawidłowy stan odtwarzacza |
Zatrzymaj
Zatrzymuje odtwarzanie bieżącej treści. Wyzwala powiadomienie o zdarzeniu STATUS dla wszystkich aplikacji nadawców. Po wykonaniu tego polecenia zawartość nie będzie już wczytywana, a obiekt mediaSessionId zostanie unieważniony.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | Liczba całkowita | Identyfikator sesji multimediów, która ma zostać zatrzymana |
| requestId | Liczba całkowita | Identyfikator żądania, aby skorelować żądanie z odpowiedzią |
| type | ciąg znaków | STOP (tylko wartość) |
| customData | obiekt | opcjonalny – obiekt blob aplikacji zdefiniowany przez aplikację nadawcy. |
| 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óra została wczytana w ramach wywołania wczytywania. Odtwarzanie jest kontynuowane od bieżącej pozycji czasowej.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | Liczba całkowita | Identyfikator sesji multimediów związanej z odtwarzaniem treści |
| requestId | Liczba całkowita | Identyfikator żądania, aby skorelować żądanie z odpowiedzią |
| type | ciąg znaków | PLAY (tylko wartość) |
| customData | obiekt | opcjonalny – obiekt blob aplikacji zdefiniowany przez aplikację nadawcy. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| Brak | Zmiana stanu odbiornika | Komunikat o zmianie stanu multimediów | Nieprawidłowy stan odtwarzacza |
Pobierz stan
Pobiera stan multimediów.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | Liczba całkowita | Opcjonalne: identyfikator sesji multimediów, dla którego ma zostać zwrócony stan mediów. Jeśli nie podasz żadnej wartości, będzie podany stan wszystkich identyfikatorów sesji multimediów. |
| requestId | Liczba całkowita | Identyfikator żądania, aby skorelować żądanie z odpowiedzią |
| type | ciąg znaków | GET_STATUS (tylko wartość) |
| customData | obiekt | opcjonalny – obiekt blob aplikacji zdefiniowany przez aplikację nadawcy. |
| Odpowiedź | Aktywatory | Nadawanie | Błędy |
|---|---|---|---|
| wiadomość MediaStatus do nadawcy, który wysłał żądanie; | Brak | Brak | Brak |
SetVolume
Ustawia głośność strumienia multimediów. Służy do obsługi efektów w strumieniu multimediów. (Uwaga: głośność odbiorcy można zmienić za pomocą polecenia setVolume w witrynie nadawcy). Głośność transmisji nie może być używana w połączeniu z suwakiem głośności lub przyciskami głośności do regulacji głośności urządzenia. Zmiana głośności strumienia nie aktywuje żadnego interfejsu użytkownika na odbiorniku.
| Nazwa | Typ | Opis |
|---|---|---|
| mediaSessionId | Liczba całkowita | Identyfikator sesji multimediów, w której przypadku zmieniono głośność strumienia |
| requestId | Liczba całkowita | Identyfikator żądania, aby skorelować żądanie z odpowiedzią |
| type | ciąg znaków | VOLUME (tylko wartość) |
| ilość | Głośność | Głośność strumienia |
| customData | obiekt | opcjonalny – obiekt blob aplikacji zdefiniowany przez aplikację nadawcy. |
| 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
Adresat wysyła 2 typy wiadomości:
- Błędy: wiadomości Unicast są wysyłane po wystąpieniu błędu w odpowiedzi na żądanie nadawcy.
- Stan: komunikaty.
- Konsekwencja działania wywołanego przez nadawcę. Będzie zawierać identyfikator żądania, które spowodowało zmianę.
- Spontaniczne: na przykład z powodu zmiany wywołanej przez aplikację odbiorcy. Element RequestId będzie miał wartość 0.
Błąd: nieprawidłowy stan odtwarzacza
Wysyłane, gdy nie można zrealizować żądania nadawcy, 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 spowodowało ten błąd |
| type | ciąg znaków | FAILED_PLAYER_STATE (tylko wartość) |
| customData | obiekt | opcjonalny : obiekt blob danych zdefiniowany przez aplikację odbierającą. |
Błąd: nie udało się wczytać
Wysyłane, gdy żądanie wczytania nie powiodło się. Stan odtwarzacza będzie nieaktywny.
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | Liczba całkowita | Identyfikator żądania, które spowodowało ten błąd |
| type | ciąg znaków | LOAD_FAILED (tylko wartość) |
| customData | obiekt | opcjonalny : obiekt blob danych zdefiniowany przez aplikację odbierającą. |
Błąd: ładowanie anulowane
Wysyłane, gdy żądanie wczytania zostało anulowane (otrzymano drugie żądanie wczytania).
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | Liczba całkowita | Identyfikator żądania, które spowodowało ten błąd |
| type | ciąg znaków | LOAD_CANCELLED (tylko wartość) |
| customData | obiekt | opcjonalny : obiekt blob danych zdefiniowany przez aplikację odbierającą. |
Błąd: nieprawidłowe żądanie
Wysyłane, gdy żądanie jest nieprawidłowe (np. nieznany typ żądania).
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | Liczba całkowita | Identyfikator żądania, które spowodowało ten błąd |
| type | ciąg znaków | FAILED_REQUEST (tylko wartość) |
| powód | Enum (ciąg znaków) | Wartości:
|
| customData | obiekt | opcjonalny : obiekt blob danych zdefiniowany przez aplikację odbierającą. |
Stan multimediów
Wysyłane po zmianie stanu lub po przesłaniu prośby o stan mediów. Zostaną wysłane tylko obiekty MediaStatus, które zostały zmienione lub których zażądano.
| Nazwa | Typ | Opis |
|---|---|---|
| requestId | Liczba całkowita | Identyfikator używany do korelowania tej odpowiedzi o stanie z żądaniem, które ją wysłało, lub 0, jeśli komunikat o stanie jest spontaniczny (nie jest wywoływany przez żądanie nadawcy). Aplikacje nadawców będą generować unikalne identyfikatory żądań, wybierając losową liczbę i stale ją zwiększając (nie będą używać wartości 0). |
| type | ciąg znaków | MEDIA_STATUS (tylko wartość) |
| stan | MediaStatus[] | Tablica obiektów Media Status. UWAGA: element mediów w MediaStatus zostanie zwrócony tylko wtedy, gdy został zmieniony. |
| customData | obiekt | opcjonalny : obiekt blob danych zdefiniowany przez aplikację odbierającą. |