Przegląd

Pakiet SDK Cast pozwala użytkownikowi wybrać strumieniowane treści audiowizualne za pomocą nadawcy i odtworzyć (lub przesłać) je na innym urządzeniu nazywanym odbiornikiem, jednocześnie kontrolując odtwarzanie za pomocą nadawcy.

Termin Nadawca odnosi się do aplikacji, która pełni rolę kontrolera podczas sesji przesyłania. Nadawca inicjuje sesję przesyłania i zarządza interakcję użytkownika z treścią.

Jest wiele rodzajów nadawców, w tym aplikacje mobilne i aplikacje internetowe Google Chrome, a także wirtualne platformy sterujące na urządzeniach Google Home z funkcją dotykową. Elementy sterujące multimediami w przeglądarce Chrome działają jako nadawca, podobnie jak Asystent Google.

Termin Odbiornik oznacza aplikację działającą na urządzeniu obsługującym Cast, która odpowiada za odpowiadanie na polecenia nadawcy i przesyłanie treści przesyłanych strumieniowo z usługi strumieniowego przesyłania danych online na urządzenie obsługujące Cast. Przykłady odbiorników obsługujących Cast to m.in. Chromecasty, telewizory smart TV, inteligentne ekrany i inteligentne głośniki.

Pakiet SDK Cast obsługuje też wielu nadawców podczas łączenia się z sesją przesyłania. Na przykład jeden nadawca może rozpocząć sesję na odbiorniku, a inny może dołączyć do tej samej sesji, aby sterować odtwarzaniem, wczytywać nowe treści lub dodać kolejne treści do kolejki później.

Komponenty i architektura aplikacji

Google Cast obsługuje funkcję tworzenia aplikacji nadawcy na Androida i iOS oraz platformy internetowe obsługujące Cast, takie jak Google Chrome.

Aplikacja odbiornika działa na urządzeniu obsługującym Cast. Oto przykłady:

• Chromecast podłączony do telewizora lub systemu audio HD.
• Telewizor obsługujący Cast.
• Inteligentny ekran obsługujący Cast.
• Urządzenie z Androidem, które obsługuje Cast, na przykład Android TV.

Uwaga: protokół przesyłania jest niezależny od platformy, więc nadawcy przesyłania z konkretnej witryny lub usługi mogą działać na dowolnej z obsługiwanych platform (internet, iOS lub Android) i wchodzić w interakcje z odpowiednim odbiornikiem przesyłania działającym w przeglądarce lub na Androidzie. Odbiorniki (z wyjątkiem domyślnego odbiornika) są rejestrowane za pomocą osobnego identyfikatora aplikacji, który służy do „kluczy” odpowiednich aplikacji nadawcy do odbiornika. Ten mechanizm uniemożliwia nadawcy dołączanie do odbiorników innych niż te, które mają ten sam identyfikator aplikacji, i sterowanie nimi.

Nadawca steruje odtwarzaniem multimediów w odbiorniku, używając wiadomości odtwarzania multimediów zdefiniowanych w pakiecie SDK. Jeśli przypadek użycia aplikacji wymaga wysyłania danych, które nie zostały oficjalnie zdefiniowane w standardowych wiadomościach dotyczących odtwarzania multimediów, do przekazywania danych pomocniczych możesz użyć pola customData, które jest dostępne w kilku typach wiadomości.

Są dwa podstawowe scenariusze tworzenia aplikacji Cast:

1. Kompleksowe rozwiązanie oparte na Cast. W tym przypadku deweloper musi utworzyć zarówno aplikację nadawcy, jak i 2 aplikacje do odbioru: odbiornik Android TV i odbiornik internetowy (więcej informacji na ten temat znajdziesz poniżej).
2. Aplikacja nadawcy obsługująca Cast, która może przesyłać treści (ekran lub strumień multimediów) do domyślnego odbiornika Google Cast, który jest nazywany domyślnym odbiornikiem multimediów. W tym przypadku deweloper musi stworzyć tylko jedną aplikację – nadawcę. Domyślny odbiornik multimediów jest przydatny w sytuacjach uczących się, w przypadku których często odtwarzane są bardzo ograniczone fragmenty. Nie jest to przydatne dla odbiorców, którzy wymagają niestandardowej logiki biznesowej, danych logowania, zarządzania prawami lub statystyk.

Pakiet SDK Google Cast

Pakiet SDK Google Cast składa się z kilku bibliotek interfejsu Cast API. Oprócz interfejsów API istnieją 2 rodzaje dokumentacji:

• przewodniki po interfejsach API, które podpowiadają, jak korzystać z interfejsów API, wraz z przykładowym kodem demonstracyjnym funkcji przesyłania.
• Samouczki z programowaniem dotyczące procesu programowania konkretnych rodzajów aplikacji Cast.

Interfejsy Cast API są podzielone według platformy i typu aplikacji Cast. Tabela 1 zawiera linki do przewodników po różnych interfejsach API Cast.

Tabela 1. Przewodniki po pakiecie Cast SDK

Platforma	Nadawca	Odbiornik
Android	Aplikacje do wysyłania wiadomości na Androida	Omówienie odbiornika Android TV
Sieć	Aplikacje Web Sender	Omówienie odbiornika internetowego
iOS	Aplikacje do nadawcy w iOS	Nie dotyczy

Typy aplikacji nadawców

Aplikacje nadawców mogą działać na 3 platformach:

• Sieć
• Android
• iOS

Chociaż wybór typu nadawcy prawdopodobnie będzie zależeć głównie od platform nadawców, które chcesz obsługiwać, warto znać możliwości i ograniczenia poszczególnych typów nadawców (patrz tabela 3).

Tabela 3. Porównanie nadawców

Funkcja	Nadawca w Androidzie	Nadawca w systemie iOS	Web Sender
Przerwy na reklamę i reklamy towarzyszące w strumieniu multimediów
Ścieżki tekstowe ze stylizowanymi ścieżkami
Grupowanie, stylizowanie i aktywowanie ścieżek multimediów
Autoodtwarzanie i kolejkowanie (edytowanie, zmienianie kolejności, aktualizowanie)
Kanały niestandardowe
Działania niestandardowe
Pełny interfejs Cast, w tym kontroler i minikontroler
Chcę dołączyć

Typy aplikacji odbierających

Aplikacje odbierające obsługują komunikację między aplikacją nadawcy a urządzeniem przesyłającym. Istnieją 2 główne typy odbiorników: odbiornik internetowy i odbiornik Android TV. Wymagany jest co najmniej odbiornik internetowy. Zalecamy również dodanie odbiornika Android TV, aby zapewnić użytkownikom maksymalną wygodę korzystania z aplikacji.

Istnieją 3 typy odbiorników internetowych. Każdy z nich ma inne cechy i możliwości:

• Niestandardowy odbiornik, który umożliwia modyfikowanie logiki, budowania marki i modyfikowanie elementów sterujących.
• Odbiornik multimediów w stylu, który umożliwia dostosowanie marki.
• Domyślny odbiornik, czyli najbardziej podstawowy typ. Nie można go spersonalizować i nie jest odpowiedni w przypadku aplikacji produkcyjnych.

Oprócz możliwości zapewnianych przez niestandardowy odbiornik odbiornik Android TV dostarcza usługę Cast Connect, czyli zestaw funkcji, które zapewniają użytkownikom natywne wrażenia, płynnie łącząc przesyłanie z Androidem TV.

Tabela 2 przedstawia możliwości różnych typów odbiorników.

Tabela 2. Porównanie odbiorników

	Odbiornik Android TV	Niestandardowy odbiornik	Odbiornik SMR	Domyślny odbiornik multimediów
Platforma
Aplikacje na Androida (Java/Kotlin)
Oparty na przeglądarce (HTML5)
Wymagania
Musi być zarejestrowana
Możliwości
Odtwarzanie multimediów HLS i DASH
Obsługa sterowania dotykowego
Obsługuje polecenia głosowe z urządzeń z Asystentem
Możliwość dostosowania stylu wizualnego i marki
Obsługa wiadomości niestandardowych
Połączenie Cast

Wybór między 3 opcjami odbiornika internetowego zależy od typów multimediów obsługiwanych przez aplikację, stopnia dostosowania interfejsu użytkownika i wymagań dotyczących logiki niestandardowej.

Ostrzeżenie: aby zintegrować interfejs Cast API z aplikacją, musi ona używać formatu multimedialnego obsługiwanego przez Cast, takiego jak HLS lub DASH. Jeśli Twoja aplikacja wymaga nieobsługiwanego formatu multimediów, nie będzie można zintegrować przesyłania z aplikacją.

Określenie typu odbiornika internetowego, które należy utworzyć

Jeśli Twoja aplikacja może integrować się z przesyłaniem, skorzystaj z poniższych promptów, aby określić, jaki odbiornik internetowy należy stworzyć:

Utwórz niestandardowy odbiornik, jeśli:
Aplikacja wymaga co najmniej 1 z tych funkcji specjalnych: Styl, który nie jest dostarczony przez odbiornik stylu multimedialnego Modyfikacje sterowania dotykowego Autoryzacja lub uwierzytelnianie Statystyki odbiornika Licencja DRM dostarczana oddzielnie od pliku manifestu. Przed reklamami, w trakcie ich trwania i po ich zakończeniu Wszelkie inne niestandardowe funkcje odbiornika lub niestandardowe logiki JavaScript	LUB	Aplikacja wymaga niestandardowego stylu ORAZ Możliwości określania stylu odbiornika multimediów są niewystarczające

Utwórz odbiornik multimediów ze stylem, jeśli:

Aplikacja wymaga niestandardowego stylu ORAZ Możliwości stylu odbiornika multimediów są wystarczające ORAZ Aplikacja nie wymaga żadnych specjalnych funkcji wymienionych powyżej.

Użyj domyślnego odbiornika multimediów, jeśli:

Format multimediów jest obsługiwany ORAZ Aplikacja nie wymaga niestandardowego stylu ORAZ Aplikacja nie wymaga żadnych specjalnych funkcji wymienionych powyżej.