Opis

Pakiet SDK Cast pozwala użytkownikowi wybrać strumieniowe przesyłanie treści audiowizualnych przy użyciu nadawcy i odtworzyć je na innym urządzeniu nazywanym odbiornikiem (i jednocześnie odtwarzać je za pomocą nadawcy).

Nadawca to aplikacja, która pełni funkcję kontrolera w sesji przesyłania. Nadawca inicjuje sesję przesyłania i zarządza interakcją użytkownika z treścią.

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

Termin Odbiornik dotyczy aplikacji uruchomionej na urządzeniu obsługującym Cast, które odpowiada na polecenia nadawcy i przesyła treści strumieniowo z usługi przesyłania strumieniowego online na urządzenie obsługujące Cast. Przykładami urządzeń obsługujących odbiornik są Chromecasty, telewizory smart TV, inteligentne ekrany i inteligentne głośniki.

Ten pakiet obsługuje też kilku nadawców połączonych 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, by kontrolować odtwarzanie, wczytywać nowe treści lub dodawać do kolejki więcej treści na później.

Komponenty i architektura aplikacji

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

Aplikacja odbiornika działa na urządzeniu obsługującym Cast. Przykłady takich aplikacji to:

• Chromecasta podłączonego do telewizora lub systemu audio o wysokiej rozdzielczości.
• telewizor obsługujący Cast.
• Ekran inteligentny obsługujący Cast.
• urządzenie z Androidem, które obsługuje Cast, np. Android TV.

Uwaga: protokół Cast jest niezależny od platformy, więc jego nadawcy w danej witrynie lub usłudze mogą działać na dowolnej obsługiwanej platformie (Web, iOS lub Android) i współpracować z odpowiednim odbiornikiem Cast w przeglądarce lub systemie Android. Odbiorniki (z wyjątkiem domyślnego odbiornika) są rejestrowane za pomocą oddzielnego identyfikatora aplikacji, który służy do „kluczowego” dostępu do odpowiednich aplikacji nadawcy. Ten mechanizm uniemożliwia nadawcy dołączenie do niego adresatów i sterowanie nimi innymi od tych, które używają tego samego identyfikatora aplikacji.

Nadawca kontroluje odtwarzanie multimediów na odbiorniku przy użyciu wiadomości odtwarzania zdefiniowanych przez pakiet SDK. Jeśli przypadek użycia aplikacji wymaga wysyłania danych, które nie są formalnie zdefiniowane w standardowych wiadomościach odtwarzania, możesz użyć pola customData udostępnionego przez kilka typów wiadomości, aby przekazać dane poboczne.

Istnieją 2 podstawowe scenariusze tworzenia aplikacji Cast:

1. Kompleksowe rozwiązanie oparte na Cast. W tym scenariuszu deweloper musi utworzyć zarówno aplikację Sender, jak i dwie aplikacje odbiornika: odbiornik Android TV i odbiornik internetowy (więcej informacji na ten temat znajdziesz poniżej).
2. Aplikacja obsługująca Cast, która może przesyłać treści (ekran lub strumień multimedialny) na domyślny odbiornik Google (nazywany domyślnym odbiornikiem multimedialnym). W tym scenariuszu deweloper musi utworzyć tylko jedną aplikację – nadawcę. Domyślny odbiornik jest przydatny do nauki i do bardzo ograniczonych scenariuszy odtwarzania. Nie jest to praktyczne rozwiązanie w przypadku odbiorców, którzy potrzebują niestandardowej logiki biznesowej, danych uwierzytelniających, zarządzania prawami czy analizy.

Pakiet SDK Google Cast

Pakiet SDK Google Cast zawiera kilka bibliotek interfejsu API Cast. Oprócz interfejsów API dostępne są 2 rodzaje dokumentacji:

• Przewodniki po interfejsach API pokazujące, jak korzystać z interfejsów API z przykładowym kodem przedstawiającym funkcje przesyłania.
• Samouczki z programowania, które zawierają instrukcje tworzenia konkretnych rodzajów aplikacji Cast.

Interfejsy API przesyłania są podzielone według platformy i typu aplikacji Cast. Tabela 1 zawiera linki do przewodników dotyczących różnych interfejsów API przesyłania.

Tabela 1. Instrukcje dotyczące przesyłania pakietów SDK

Platforma	Nadawca	Odbiornik
Android	Aplikacje nadawcy na Androida	Omówienie odbiornika Android TV
Sieć	Aplikacje do przesyłania internetowego	Omówienie odbiornika internetowego
iOS	Aplikacje nadawcy w iOS	Nie dotyczy

Typy aplikacji nadawcy

Aplikacje nadawcy działają na 3 platformach:

• Sieć
• Android
• iOS

Wybór typu nadawcy zależy zwykle od platform, które zamierzasz obsługiwać, ale musisz znać możliwości i ograniczenia poszczególnych typów nadawców (patrz tabela 3).

Tabela 3. Porównanie nadawców

Możliwości	Nadawca Androida	Nadawca na iOS	Nadawca internetowy
Przerwy na reklamy i reklamy towarzyszące w strumieniu mediów
Stylowe ścieżki tekstowe
Grupowanie, ustawianie stylu i aktywowanie ścieżek audio
Autoodtwarzanie i kolejka (edycja, zmiana kolejności, aktualizacja)
Kanały niestandardowe
Działania niestandardowe
Interfejs Full Cast, w tym kontroler i mikrokontroler
Zamiar dołączenia

Typy aplikacji odbiornika

Aplikacje odbiornika obsługują komunikację między aplikacją Nadawca a urządzeniem przesyłającym. Istnieją 2 główne typy odbiorników: odbiornik internetowy i odbiornik Androida TV. Od odbiornika internetowego wymaga się przynajmniej odbiornika. Aby zwiększyć komfort korzystania z aplikacji, najlepiej dodać odbiornik Androida TV.

Istnieją 3 typy odbiorników internetowych, każdy z innym zestawem cech i możliwości:

• Niestandardowy odbiornik, który pozwala na niestandardowe logikę, promowanie marki i modyfikowanie ustawień.
• Stylowy odbiornik mediów, który umożliwia dostosowywanie własnej marki.
• Domyślny odbiornik (najbardziej podstawowy). Ta opcja nie umożliwia żadnych dostosowań i nie jest odpowiednia dla aplikacji produkcyjnych.

Oprócz funkcji niestandardowych odbiorniku Android TV dostarcza też Cast Connect, zestaw funkcji, które zapewniają użytkownikom natywny komfort, płynnie przesyłając treści z Androida TV.

Tabela 2 opisuje możliwości różnego typu odbiorników.

Tabela 2. Porównanie odbiorców

	Odbiornik Android TV	Niestandardowy odbiornik	Styl odbiornika (SMR)	Domyślny odbiornik multimediów
Platforma
Na podstawie Androida (Java/Kotlin)
W przeglądarce (HTML5)
Wymagania
Musi być zarejestrowany
Możliwości
Odtwarzanie multimediów HLS i DASH
Obsługa elementów dotykowych
Obsługa poleceń głosowych z urządzeń z Asystentem
Dostosowywany styl wizualny i budowanie marki
Obsługa wiadomości niestandardowych
Cast Cast

Wybór 3 opcji odbiornika internetowego zależy od tego, jakie typy multimediów musi obsługiwać aplikacja, stopień dostosowania interfejsu użytkownika oraz wszelkie niestandardowe wymagania logiczne.

Ostrzeżenie: aby zintegrować interfejs Cast API ze swoją aplikacją, musisz użyć formatu multimedialnego obsługiwanego przez Cast, np. HLS lub DASH. Jeśli aplikacja wymaga nieobsługiwanego formatu multimediów, nie będzie można zintegrować z nią Cast.

Określ typ odbiornika internetowego do skompilowania

Aby określić typ odbiornika internetowego, który obsługuje integracja z Cast, skorzystaj z tych instrukcji:

Utwórz niestandardowy odbiornik, jeśli:
Aplikacja wymaga co najmniej 1 z tych funkcji specjalnych: Styl nie jest obsługiwany przez stylowy odbiornik multimediów Zmiany w elementach sterowania dotykowego Autoryzacja lub uwierzytelnianie Statystyki odbiornika Licencja DRM oddzielnie od pliku manifestu Reklama przed, w trakcie lub po niej Inne funkcje niestandardowego odbiornika lub niestandardowy kod JavaScript	LUB	Aplikacja wymaga stylu niestandardowego ORAZ Funkcje stylistycznego odbiornika stylizowanych multimediów są niewystarczające

Utwórz stylowy odbiornik multimediów, jeśli:

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

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

Obsługiwane formaty multimediów ORAZ Aplikacja nie wymaga stylu niestandardowego ORAZ Aplikacja nie wymaga żadnych specjalnych funkcji wymienionych powyżej