Niestandardowy odbiornik internetowy

Szybki start – kod do utworzenia podstawowego niestandardowego odbiornika internetowego jest prosty. Przejdź do sekcji rejestrowania aplikacji internetowej i tworzenia podstawowej aplikacji.

Wbudowany odtwarzacz multimediów pozwala na bezproblemowe odtwarzanie treści za pomocą wbudowanego odtwarzacza multimediów. Obsługuje Asystenta Google oraz funkcje Cast, które są automatycznie obsługiwane przez wszystkich nadawców i urządzenia z ekranem dotykowym. Nowe funkcje będą nadal obsługiwane bez dodatkowych zmian nadawcy.

Niestandardowy odbiornik internetowy to niestandardowa aplikacja HTML5, która musi być hostowana, aby można było wyświetlać treści na urządzeniach obsługujących Cast. W zależności od potrzeb biznesowych konieczne może być utworzenie niestandardowego odbiornika internetowego. Aby dowiedzieć się, jaki typ odbiornika wybrać, przeczytaj przewodnik dotyczący odbiornika internetowego.

Pakiet SDK odbiornika internetowego Google

Aplikacja Web odbiornika ma dostęp do interfejsu Web odbiornik API za pomocą tego pliku:

<script src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>

Sprawdzone metody w przypadku protokołów URL: powyższy adres URL nie określa protokołu "http:" &httpst". Pominięcie tych protokołów podczas pozyskiwania zasobu cast_receiver_framework.js umożliwia pobranie tego zasobu przy użyciu tego samego protokołu co serwer hostujący aplikację Web odbiornik. Oznacza to, że przełączanie między HTTP a środowiskiem programistycznym i HTTPS dla środowiska produkcyjnego jest przejrzyste i nie wymaga zmiany kodu. Opublikowane aplikacje odbiornika internetowego muszą być hostowane na serwerach obsługujących protokół TLS.

Podgląd pakietu SDK

Przedpremierowa wersja pakietu SDK Web odbiornika jest też dostępna do testowania aplikacji nieprodukcyjnych. Więcej informacji o adresie URL podglądu pakietu SDK pakietu SDK znajdziesz tutaj: URL podglądu pakietu SDK odbiornika internetowego Google Cast.

Cykl życia aplikacji

Cykl życia aplikacji internetowej odbiornika zaczyna się od punktu, w którym odbiornik internetowy jest ładowany na urządzeniu przesyłającym, a następnie przechodzi do punktu, w którym aplikacja jest wyłączona, a urządzenie przesyłające wraca do stanu domyślnego.

W trakcie cyklu życia aplikacji odbiornika internetowego wiadomości mogą być wymieniane między odbiornikiem a wszystkimi połączonymi aplikacjami nadawcy. Aplikacja nadawcy wysyła na urządzenie Google Cast wstępną wiadomość z prośbą o utworzenie sesji z użyciem konkretnego identyfikatora aplikacji. Spowoduje to rozpoczęcie cyklu życia odbiornika, ponieważ urządzenie Google Cast spróbuje załadować aplikację Web odbiornik. Zakładając, że nie występują problemy z siecią, aplikacja Web odbiornik zostanie pobrana z sieci przy użyciu rozwiązanego adresu URL powiązanego z identyfikatorem aplikacji. Po załadowaniu aplikacja Web odbiornik wykonuje operacje konfiguracji i wskazuje, że jest gotowa do przetwarzania wiadomości z dowolnych połączonych aplikacji nadawcy.

Aplikacja YouTube odbiornik może zostać wyłączona (zakończyć bieżący cykl życia i zamknąć aplikację) w tych warunkach:

  • Aplikacja Web odbiornik otrzymuje ostatninadawca połączony, aby zakończyć sesję aplikacji.
  • Aplikacja Web odbiornik jest nieaktywna przez określony czas bez żadnych połączonych nadawców i decyduje się zakończyć sesję aplikacji.
  • Rozpoczęto inną sesję przesyłania.
  • W czasie normalnego cyklu życia odbiornik internetowy napotkał błąd krytyczny.

Web odbiornik SDK obsługuje wszystkie typowe przypadki zgodnie z naszymi wytycznymi dotyczącymi UX.

Zajęcia popularne

Platforma Web odbiornik SDK ma 2 główne klasy:

  • cast.framework.CastReceiverContext – zarządza ogólną biblioteką i wczytuje niezbędne biblioteki. Przy użyciu tego obiektu możesz:

    • Ustaw opcje konfiguracji aplikacji
    • Obsługuj zdarzenia systemowe (np. połączenie lub odłączenie nadawcy)
    • Tworzenie kanałów niestandardowych
    • Rozpocznij przesyłanie
  • cast.framework.PlayerManager – zarządza odtwarzaniem multimediów. Obsługuje odpowiedni odtwarzacz i element multimedialny zgodnie z żądaniem nadawcy. Przy użyciu tego obiektu możesz:

    • Obsługa operacji odtwarzania
    • Obsługiwanie żądań związanych z odtwarzaniem od nadawców
    • Obsługa zdarzeń związanych z odtwarzaniem

Rejestrowanie aplikacji internetowej

Zanim stworzysz aplikację Web odbiornik, musisz zarejestrować ją w Google Play SDK Console. Więcej informacji znajdziesz w artykule Rejestracja. Wszystkie aplikacje Odbiornika WWW wymagają, aby aplikacje nadawcy dostarczały identyfikator aplikacji z komunikatami poleceń wysyłanymi do Odbierającego przez interfejs API nadawcy. Po zarejestrowaniu aplikacji internetowej odbiornika otrzymasz identyfikator aplikacji, który ma być uwzględniany w wywołaniach interfejsu nadawcy i interfejsu API.

Konfigurowanie podstawowej aplikacji internetowej

Poniżej znajduje się główna struktura podstawowej aplikacji internetowej, której nie można dostosowywać:

  1. Element HTML cast-media-player reprezentujący odtwarzacz.
  2. Element HTML skryptu do wczytania platformy Web odbiornika.
  3. Wywołaj start(), aby uruchomić aplikację Web odbiornik bez żadnych opcji.

Oto minimalny kod aplikacji internetowej za pomocą ramki aplikacji Cast bez konieczności dostosowywania. Możesz skopiować i wkleić ten skrypt bezpośrednio do aplikacji, aby utworzyć jej odbiornik.

<html>
<head>
  <script type="text/javascript"
      src="//www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js">
  </script>
</head>
<body>
  <cast-media-player></cast-media-player>
  <script>
    cast.framework.CastReceiverContext.getInstance().start();
  </script>
</body>
</html>

W tym momencie użytkownik może otworzyć aplikację nadawcy, połączyć się z urządzeniem przesyłającym, a następnie przejść do multimediów i nacisnąć Play, aby poinformować odbiornik internetowy, że ma rozpocząć transmisję multimediów na telewizorze.

Porównaj ten podstawowy odbiornik z dostosowaną aplikacją odbiornika.

Multimedia i odtwarzacze

Platforma Cast to wbudowany odtwarzacz multimediów reprezentowany przez element HTML cast-media-player. Odtwarzacz obsługuje protokoły strumieniowe, takie jak MPEG-DASH, HLS i Smooth Streaming.

Zestaw obsługiwanych kodeków i kontenerów znajduje się na stronie Obsługiwane multimedia. Dzięki wiadomościom Cast Listę obsługiwanych operacji znajdziesz w dokumentacji API nadawcy dla platformy aplikacji: RemoteMediaClient w Android Sender, GCKMediaControlChannel w Android Sender i Media w Web Sender.

Udostępnianie zasobów z innych domen

Google Cast w pełni obsługuje współdzielenie zasobów (CORS). Protokoły strumieniowego przesyłania danych, w przeciwieństwie do większości protokołów opartych na plikach, uzyskują dostęp do treści w sposób asynchroniczny, korzystając z XMLHttpRequest. W świecie CORS żądania te są chronione przed nieodpowiednim dostępem przez nagłówek CORS z serwera, z którego pochodzi zasób. Oznacza to, że serwer treści mówi, gdzie mogą się one pojawiać. Większość nowoczesnych przeglądarek w pełni obsługuje protokół CORS. Urządzenia z iOS i Androidem uzyskują dostęp do treści na niższym poziomie i nie przeglądają tych nagłówków. Często jest to pierwszy problem, który pojawia się, gdy deweloper chce skorzystać z treści przesyłanych strumieniowo. Aby dowiedzieć się więcej, zobacz Udostępnianie zasobów z innych domen.