Niestandardowy odbiornik internetowy

Szybki start – kod do tworzenia podstawowej niestandardowych witryn internetowych. Odbiornik jest prosty. Przejdź do rejestrowanie odbiornika internetowego aplikację, a następnie utwórz podstawowy Aplikacja Web Receiver

Pakiet Web Receiver SDK korzysta z wbudowanego odtwarzacza multimediów, aby zapewnić związane z odtwarzaniem. Oferuje również gotowe wsparcie dla Asystenta Google jako funkcje związane z Cast, które są automatycznie obsługiwane u wszystkich nadawców i urządzenia z funkcją dotykową. W miarę udostępniania nowych funkcji będą one obsługiwane bez wprowadzania dodatkowych zmian w informacjach o nadawcy.

Niestandardowy odbiornik internetowy to niestandardowa aplikacja HTML5, która musi być hostowana wyświetlania treści na urządzeniach obsługujących Cast. Może być konieczne utworzenie Odbiornik internetowy w zależności od potrzeb biznesowych. Pomoc w wyborze odbiorcy i typu, którego chcesz użyć, patrz wybierz przewodnik dotyczący odbiornika internetowego.

Pakiet SDK Google Web Receiver

Aplikacja Web Receiver uzyskuje dostęp do interfejsu Web Receiver API za pomocą odniesienie:

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

Sprawdzona metoda dotycząca protokołów adresów URL: pamiętaj, że podany powyżej adres URL nie określa tagu "http:" lub „https:” protokołu. Pomijanie tych protokołów przy pozyskaniu Zasób cast_receiver_framework.js umożliwia pobranie tego zasobu za pomocą ten sam protokół co serwer hostujący aplikację Web Receiver. Oznacza to, że Przełączanie między protokołem HTTP w wersji programistycznej i HTTPS w przypadku środowiska produkcyjnego jest przejrzyste i nie wymagają zmiany kodu. (Opublikowane aplikacje odbiornika internetowego muszą być hostowane na serwerach obsługujących protokół TLS).

Nie hostuj Zasób cast_receiver_framework.js (SDK Web Receiver SDK), a nawet nie do lokalnego rozwoju. Zawsze używaj pakietu SDK odbiornika internetowego hostowanego przez Google, korzystając z odniesienia do gstatic.com. Pakiet Web Receiver SDK hostowany przez Google jest zgodny z oprogramowaniem platformy i jest okresowo aktualizowany naprawiać błędy i dodawać nowe funkcje. W trakcie tworzenia aplikacji możesz hostować Aplikacja odbiornika internetowego lokalnie w sieci prywatnej na potrzeby testowania, ale hostowana w internecie Lokalny pakiet SDK odbiornika może spowodować awarię aplikacji.

Wersja testowa pakietu SDK

Przedpremierowa wersja SDK Cast Web Receiver SDK jest też dostępna w testowania aplikacji nieprodukcyjnych. Więcej informacji o adresie URL podglądu pakietu SDK znajdziesz pod adresem URL podglądu pakietu SDK Google Cast Web Receiver.

Cykl życia aplikacji

Cykl życia aplikacji odbiornik internetowy rozpoczyna się od punktu, w którym odbiornik internetowy jest wczytywany na urządzenie przesyłające i przechodzi do punktu, aplikacja zostanie wyłączona i urządzenie przesyłające zostanie przywrócone do stanu domyślnego.

W cyklu życia aplikacji Web Receiver wiadomości są wymieniane między Odbiornik internetowy i wszelkie podłączone aplikacje nadawcy. Aplikacja nadawcy wyślij pierwszą wiadomość do urządzenia Google Cast z prośbą o utworzenie sesji przy użyciu określonego identyfikatora aplikacji. Powoduje to rozpoczęcie cyklu życia odbiornika internetowego, urządzenie Google Cast spróbuje załadować aplikację Web Receiver. Zakładając, że nie występują problemy z siecią, aplikacja Web Receiver zostanie pobrana z sieci używając adresu URL powiązanego z identyfikatorem aplikacji. Po załadowaniu odbiornik internetowy wykona operacje konfiguracji i wskazuje, że aplikacja jest gotowa do przetworzenia. wiadomości ze wszystkich połączonych aplikacji nadawców.

Aplikacja Web Receiver może ulec awarii (zakończyć bieżący cykl życia i zamknąć aplikacji) pod następującymi warunkami:

• Aplikacja Web Receiver otrzymuje wiadomość od ostatniego połączonego urządzenia na zakończenie sesji aplikacji.
• Aplikacja Web Receiver jest bezczynna przez określony czas i nie nadawcom i postanawia zakończyć sesję w aplikacji.
• Rozpoczęła się inna sesja przesyłania.
• Odbiornik internetowy napotka błąd krytyczny podczas normalnego cyklu życia.

Pakiet Web Receiver SDK obsługuje wszystkie typowe przypadki zgodnie z wskazówkami dotyczącymi UX.

Główne klasy

Platforma SDK Web Receiver SDK dzieli się na 2 główne klasy:

• cast.framework.CastReceiverContext – zarządza i wczytuje niezbędne biblioteki. Za jego pomocą możesz:

  • Ustawianie opcji konfiguracji aplikacji
  • Obsługuj zdarzenia systemowe (np. połączenie lub odłączenie nadawcy)
  • Utwórz kanały niestandardowe
  • Rozpocznij komunikację podczas przesyłania

• cast.framework.PlayerManager – zarządza multimediami odtwarzania. Obsługuje odtwarzacz i element multimedialny zgodnie z od nadawcy. Za jego pomocą możesz:

  • Obsługa operacji odtwarzania
  • Obsługa próśb nadawcy dotyczących odtwarzania
  • Obsługa zdarzeń związanych z odtwarzaniem

Zarejestruj aplikację odbiornika internetowego

Przed opracowaniem aplikacji odbiornika internetowego musisz zarejestrować Aplikacja odbiornika z konsolą programisty pakietu Google Cast SDK. Zobacz Zarejestruj się, aby uzyskać więcej informacji. Wszystkie odbiorniki internetowe wymagają, aby aplikacje nadawcy przekazywały identyfikator aplikacji w komunikatach poleceń wysyła do odbiornika internetowego za pomocą interfejsu API nadawcy. Gdy zarejestrujesz witrynę aplikacji odbiornika, otrzymasz identyfikator aplikacji do dołączenia do Wywołania interfejsu API.

Tworzenie podstawowej aplikacji odbiornika internetowego

Poniżej przedstawiono główną strukturę podstawowej aplikacji odbiornika internetowego, która nie ma dostosowywanie:

1. Element HTML cast-media-player reprezentujący odtwarzacz.
2. Element HTML skryptu wczytujący platformę odbiornika internetowego.
3. Zadzwoń do nas start() aby uruchomić aplikację Odbiornik internetowy bez żadnych opcji.

Oto minimalny kod aplikacji odbiornika internetowego korzystającej z aplikacji Cast Struktura bez żadnych dostosowań. Możesz skopiować i wkleić ten skrypt w aplikacji, aby utworzyć odbiornik internetowy.

<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>

Na tym etapie użytkownik może otworzyć aplikację nadawcy, połączyć się z urządzeniem przesyłającym. przejdź do multimediów i naciśnij przycisk odtwarzania, który wysyła do odbiornika internetowego multimedia na telewizor.

Porównaj ten podstawowy odbiornik internetowy z niestandardową aplikację odbiornika.

Multimedia i odtwarzacze

Platforma Cast ma wbudowany odtwarzacz, reprezentowany przez Element HTML cast-media-player. Ten odtwarzacz obsługuje odtwarzanie przez takich jak MPEG-DASH, HLS i Smooth Streaming.

Zestaw obsługiwanych kodeków i kontenerów multimediów znajdziesz na stronie Obsługiwane multimedia Dzięki komunikatorom Cast deweloperzy mogą obsługują listę operacji inicjowanych przez nadawcę, takich jak ładowanie, odtwarzanie, wstrzymywanie w którym pakiet SDK Cast obsługuje interakcje z multimediami. Lista: dotyczące obsługiwanych operacji, zapoznaj się z dokumentacją interfejsu API nadawcy dotyczącą platformy Twojej aplikacji: RemoteMediaClient w aplikacji Android Sender, GCKMediaControlChannel w aplikacji iOS Sender oraz Media w Web Senders.

Udostępnianie zasobów między serwerami z różnych domen

Google Cast w pełni obsługuje CORS. Strumieniowe przesyłanie danych W przeciwieństwie do większości protokołów opartych na plikach uzyskuje dostęp do treści za pomocą XMLHttpRequest. W świecie CORS żądania te są chronione niestosowny dostęp przy użyciu nagłówka CORS z serwera, na którym zasób Oznacza to, że serwer treści ma wpływ na to, gdzie mogą się one znajdować dołączono. Większość nowoczesnych przeglądarek w pełni obsługuje CORS. Urządzenia z iOS i Androidem uzyskać dostęp do treści na niższym poziomie i nie patrzeć na te nagłówki. To jest To często pierwszy problem, który pojawia się, gdy deweloper chce korzystać z funkcji strumieniowania. treści. Zapoznaj się z artykułem na temat współdzielenia zasobów między serwerami z różnych domen dotyczących .