Jeśli używasz Styled Media Receiver lub tworzysz niestandardowy odbiornik, musisz zarejestrować aplikację. Po zarejestrowaniu aplikacji otrzymasz identyfikator aplikacji, który jest używany przez aplikację nadawcy do wykonywania wywołań interfejsu API, np. do uruchamiania aplikacji odbiornika internetowego.
Jeśli używasz domyślnego odbiornika multimediów, nie musisz rejestrować aplikacji. Domyślny odbiornik multimediów nie pozwala na zmianę stylu interfejsu odtwarzacza multimediów i używa podanej stałej jako identyfikator aplikacji.
Musisz też zarejestrować urządzenie Google Cast, aby mogło uzyskać dostęp do aplikacji Web Receiver przed jej opublikowaniem. Po opublikowaniu aplikacji odbiorczej będzie ona dostępna na wszystkich urządzeniach z Google Cast.
Aplikacje
Rejestracja aplikacji umożliwia przetestowanie jej działania na zarejestrowanym urządzeniu z Castem przed opublikowaniem. Opublikowanie aplikacji powoduje, że jest ona dostępna na wszystkich urządzeniach z Cast.
Rejestrowanie aplikacji
Aby otrzymać identyfikator aplikacji, który jest używany z wywołaniami interfejsu API z aplikacji nadawcy, musisz zarejestrować Styled Media Receiver lub Custom Receiver.
Aby zarejestrować aplikację Cast:
- Zaloguj się w Konsoli programisty Google Cast SDK.
- Na stronie Przegląd lub Aplikacje kliknij Dodaj nową aplikację.
Wybierz typ aplikacji Web Receiver, której chcesz użyć:
Odbiornik niestandardowy
Wybierz tę opcję, jeśli Twoja aplikacja wymaga komponentów interfejsu użytkownika lub wzorów interakcji, których nie zapewnia komponent Styled Media Receiver. Wybranie opcji odbiornik niestandardowy może być konieczne, jeśli Twój typ treści nie jest wymieniony jako jeden z obsługiwanych typów multimediów odbiornika stylizowanych multimediów.
Pamiętaj, że ta opcja wymaga utworzenia pełnej aplikacji internetowej dla aplikacji Web Receiver.
Szczegółowe informacje znajdziesz w artykule Aplikacja niestandardowa odbiornika.
Odbiornik stylizowanych multimediów
Wybierz tę opcję, jeśli Twoja aplikacja przesyła strumieniowo treści wideo lub audio za pomocą jednego z obsługiwanych typów multimediów i chcesz udostępnić interfejs użytkownika na telewizorze, który używa domyślnego interfejsu odtwarzacza multimediów lub zestawu niestandardowych stylów na wierzchu domyślnego interfejsu odtwarzacza multimediów.
Dzięki niestandardowym stylom możesz definiować wygląd różnych elementów interfejsu odtwarzacza (np. ekranu powitalnego i paska postępu) po prostu przez podanie pliku CSS – nie musisz tworzyć aplikacji odbiorczej.
Więcej informacji znajdziesz w artykule Styled Media Receiver.
Podaj szczegóły aplikacji Web Receiver:
W polu Nazwa wpisz nazwę aplikacji.
Jest to nazwa aplikacji, która pojawia się podczas wczytywania odbiornika internetowego lub w stanie bezczynności, jeśli używasz odbiornika stylizowanych multimediów. Jeśli używasz odbiornika niestandardowego, wartość tego pola jest wartością domyślną stanu aplikacji, o ile nie została ona ustawiona za pomocą metody
setApplicationState.Określ wygląd aplikacji Web Receiver:
W przypadku niestandardowego odbiornika w polu URL podaj adres URL aplikacji.
Wpisz adres URL, którego urządzenie Google Cast powinno użyć podczas wczytywania aplikacji Web Receiver. Podczas tworzenia aplikacja może używać protokołu HTTP, ale po opublikowaniu musi używać protokołu HTTPS. Adres URL może prowadzić do strony HTML lub innego typu pliku, do którego można uzyskać dostęp w przeglądarce. Odbiornik internetowy może mieć wewnętrzny (zarejestrowany przez NAT) adres IP, ale nie może być na localhost, ponieważ rzadko jest to domena najwyższego poziomu. Aplikacja Web Receiver musi być publikowana przez protokół SSL (HTTPS), ale treści wczytywane w aplikacji Web Receiver mogą być udostępniane przez HTTP.
W przypadku stylizowanego odbiornika mediów w polu Skin URL (Adres URL skórki) podaj adres URL arkusza stylów.
Podaj adres URL HTTPS, który wskazuje na plik CSS znajdujący się w Twojej witrynie. Aby użyć stylów domyślnych, pozostaw to pole puste. Możesz je edytować później, jeśli chcesz dodać lub zaktualizować własne style.
Zaznacz lub odznacz pole Obsługuje przesyłanie strumieniowe przez relay.
Przekazywanie strumienia umożliwia odbiornikowi internetowemu obsługę przesyłania strumieniowego z nadajników, które nie są połączone z tą samą siecią Wi-Fi co odbiornik. Aby wyłączyć przesyłanie strumieniowe przez przekaźnik dla odbiornika, odznacz to pole.
Zaznacz lub odznacz pole wyboru Obsługa przesyłania na urządzenia z tylko dźwiękiem.
Aby umożliwić aplikacji wykrywanie Google Cast na urządzeniach audio, zaznacz to pole. Aby wyłączyć obsługę urządzeń obsługujących tylko dźwięk, odznacz to pole. Więcej informacji znajdziesz w sekcji Urządzenia audio.
Kliknij Zapisz.
Wyświetlane są szczegóły rejestracji, w tym identyfikator, nazwa, typ i stan aplikacji. Zapisz identyfikator aplikacji, ponieważ będzie on potrzebny do wywołań interfejsu Cast API w aplikacji.
Kliknij Gotowe, aby wrócić na stronę Aplikacje.
Edytowanie informacji o aplikacji
Zanim opublikujesz aplikację, musisz podać dodatkowe informacje. Możesz też zaktualizować informacje o aplikacji podane podczas rejestracji.
Aby edytować informacje o aplikacji:
- W Konsoli programisty Google Cast SDK na stronie Przegląd lub Aplikacje kliknij Identyfikator aplikacji albo kliknij Edytuj obok aplikacji, którą chcesz edytować.
- W polu Nazwa zaktualizuj nazwę podana podczas rejestracji aplikacji.
- W przypadku aplikacji odbiornika niestandardowego w polu URL zaktualizuj lokalizację zarejestrowanej aplikacji odbiornika internetowego.
- W przypadku aplikacji typu Styled Receiver w polu Skin URL zaktualizuj lokalizację arkusza stylów aplikacji.
Zaznacz lub odznacz pole Obsługuje przesyłanie strumieniowe przez relay.
Przekazywanie umożliwia odbiornikowi internetowemu obsługę przesyłania z urządzeń nadających, które nie są połączone z tą samą siecią Wi-Fi co odbiornik. Aby wyłączyć przesyłanie strumieniowe przez pośrednika w przypadku odbiornika, odznacz to pole.
Zaznacz lub odznacz pole wyboru Obsługuje przesyłanie na urządzenia audio.
Zaznacz to pole, aby umożliwić aplikacji wykrywanie Google Cast na urządzeniach audio. Aby wyłączyć obsługę urządzeń obsługujących tylko dźwięk, odznacz to pole. Więcej informacji znajdziesz w sekcji Urządzenia audio.
W sekcji Szczegóły nadawcy podaj te informacje dla każdej obsługiwanej platformy:
Android:
- pełna nazwa pakietu aplikacji.
iOS:
- Identyfikator iTunes i identyfikator pakietu wymagane przez Apple.
- Identyfikator URI uruchamiania aplikacji, który jest używany przez aplikację Google Home do uruchamiania aplikacji. Więcej informacji o wymaganym formacie identyfikatora URI znajdziesz w artykule Używanie schematów adresów URL do komunikacji z aplikacjami.
Sieć:
- adres URL witryny aplikacji;
W sekcji Szczegóły informacji określ, czy chcesz wyświetlać swoją aplikację w usługach Google, takich jak chromecast.com/apps.
W menu Kategoria wybierz kategorię najlepiej opisującą Twoją aplikację.
Uwaga: aplikacja musi obsługiwać opisane tutaj typy multimediów, a także te, które są sugerowane przez inne ustawienia. Jeśli na przykład Twoja aplikacja obsługuje Google Cast na potrzeby dźwięku, a Ty wybierzesz tutaj opcję TV i Filmy, aplikacja musi obsługiwać urządzenia tylko z dźwiękiem zgodnie z opisem w sekcji Urządzenia audio, a także musi spełniać wymagania dotyczące odtwarzania filmów.
Aby określić kraje, w których aplikacja jest dostępna, kliknij przycisk radiowy Wszystkie kraje lub Tylko w wybranych krajach. Jeśli określisz kraje, zaznacz pola obok tych krajów na wyświetlonej liście.
W polu Tytuł wpisz opisowy tytuł aplikacji.
Użyj maksymalnie 50 znaków. np. „YouTube”.
W polu Opis wpisz opis aplikacji.
Użyj maksymalnie 80 znaków. „Oglądaj ulubione kanały YouTube na najlepszym ekranie w domu”.
W sekcji Grafika kliknij znak plusa, aby przesłać ikonę aplikacji.
Obraz musi mieć wymiary 512 x 512 pikseli i może mieć przezroczyste tło.
Jeśli chcesz podać tłumaczenia pól Tytuł i Opis, w sekcji Dodaj własne tłumaczenia wybierz język w menu, kliknij Dodaj i w wyświetlonym oknie wpisz przetłumaczony tekst. Możesz też przesłać obraz ikony dla danego tłumaczenia.
Po zaktualizowaniu informacji o aplikacji kliknij Zapisz.
Opublikuj aplikację
Opublikowanie aplikacji powoduje, że staje się ona dostępna na wszystkich urządzeniach z Cast na całym świecie. Usługa ta tworzy też stronę aplikacji w usługach Google, takich jak strona z informacjami chromecast.com/apps, na której użytkownicy mogą znaleźć i pobrać aplikację. Jeśli podczas edytowania informacji o aplikacji w kroku 6 powyżej wybierzesz opcję wyświetlania aplikacji na liście, po jej opublikowaniu pojawi się ona na stronie chromecast.com/apps.
Aby opublikować aplikację:
W Konsoli programisty Google Cast SDK na stronie Przegląd lub Aplikacje kliknij Opublikuj obok aplikacji, którą chcesz opublikować.
Jeśli informacje o aplikacji są kompletne, pojawi się ekran podglądu z informacjami wprowadzonymi w sekcji Edytuj informacje o aplikacji. W przeciwnym razie pojawi się komunikat z informacjami, które musisz podać.
Aby wrócić i zaktualizować informacje, kliknij Edytuj.
Jeśli chcesz opublikować aplikację, kliknij Opublikuj.
Statystyki
Konsola programisty Google Cast SDK śledzi wydajność aplikacji. Dane o skuteczności każdej opublikowanej aplikacji możesz sprawdzić na stronie Aplikacje lub Omówienie, klikając Wyświetl w kolumnie Statystyki.
Wyświetlane są te informacje:
- Liczba odbiorników Cast, które uruchomiły aplikację
- Liczba uruchomionych sesji
- Średni czas odtwarzania multimediów (w minutach) na sesję
Jeśli w statystykach pojawi się platforma Inna, oznacza to, że nadawca nie wskazał platformy. Może to być na przykład starszy nadawca iOS, który nie został zaktualizowany.
Urządzenia
Domyślnie urządzenia Google Cast (takie jak Chromecast czy urządzenie z Androidem TV) nie są włączone do tworzenia i testowania. Aby przekształcić urządzenie w urządzenie programistyczne i uzyskać dostęp do nieopublikowanej aplikacji Web Receiver podczas procesu programowania, musisz zarejestrować urządzenie w aplikacji. Dzięki temu odbiornik będzie też dostępny z okna przeglądarki zdalnej na potrzeby debugowania (patrz Debugowanie).
Aby zarejestrować urządzenie Google Cast:
Skonfiguruj urządzenie Google Cast i połącz je z tą samą siecią Wi-Fi, do której jest podłączony komputer.
Więcej informacji znajdziesz w instrukcjach konfigurowania urządzenia do przesyłania.
Na komputerze otwórz przeglądarkę obsługującą przesyłanie.
Zaloguj się w Konsoli programisty Google Cast SDK.
Znajdź numer seryjny urządzenia, które chcesz zarejestrować.
Na stronie Przegląd lub Urządzenia kliknij Dodaj nowe urządzenie.
Wpisz numer seryjny urządzenia.
Wpisz opis i kliknij OK.
To tylko przyjazna nazwa urządzenia (nie musi być taka sama jak nazwa urządzenia podana podczas konfiguracji użytkownika).
Zanim przejdziesz dalej, odczekaj 15 minut.
Po zakończeniu rejestracji stan urządzenia zmieni się na „Gotowe do testowania”.
Ponownie uruchom urządzenie Google Cast: odłącz od niego kabel zasilający lub USB, a następnie podłącz go ponownie.
Znajdowanie numeru seryjnego urządzenia
Aby znaleźć numer seryjny dowolnego urządzenia, możesz przesłać stronę Konsoli programisty Google Cast na urządzenie:
Kliknij przycisk Cast (jakbyś chciał przesłać tę stronę).
Wyświetli się karta Cast z listą dostępnych urządzeń.
W menu wybierz urządzenie, którego numer seryjny chcesz poznać.
- W przypadku wyświetlaczy numer seryjny wyświetla się na ekranie telewizora i jest odczytywany na głos przez głośniki telewizora (aby ułatwić rozróżnienie cyfry 0 od litery O).
- W przypadku urządzeń audio numer seryjny jest odczytywany na głos na głośniku, na który jest przesyłana transmisja.
Numer seryjny oprogramowania Android TV
Urządzenia z Androidem TV (ATV) mają powiązane z sobą wiele numerów seryjnych. Numer seryjny oprogramowania (Cast) można uzyskać, przesyłając stronę Konsoli programisty Cast na urządzenie ATV w sposób opisany powyżej lub przełączając urządzenie ATV do trybu programisty i sprawdzając numer seryjny oprogramowania w ustawieniach Cast.
Aby przełączyć urządzenie ATV w tryb programisty, wybierz Ustawienia > System > Informacje > Wersja Androida TV, a następnie kliknij wersję kilka razy, aż urządzenie powiadomi Cię, że jesteś w trybie programisty. Aby znaleźć numer seryjny w trybie programisty, w zależności od modelu ATV otwórz Ustawienia > Preferencje urządzenia > Chromecast wbudowany lub Ustawienia > System > Cast. Numer seryjny oprogramowania będzie widoczny na ekranie.
Pamiętaj, że po przywróceniu urządzenia ATV do ustawień fabrycznych numer seryjny oprogramowania ulegnie zmianie. Po przywróceniu urządzenia do ustawień fabrycznych wykonaj opisane powyżej czynności, aby znaleźć numer seryjny oprogramowania, i ponownie zarejestruj nowy numer seryjny oprogramowania w Konsoli deweloperskiej Chromecasta.
Problemy dotyczące konta
Chcę anulować rejestrację w Konsoli programisty Google Cast
Opłata za rejestrację konta dewelopera w wysokości 5 USD nie podlega zwrotowi.
Nie mam już dostępu do konsoli programisty Google Cast
Jeśli wcześniej otrzymaliśmy od Ciebie e-maila z informacją, że Twoje konto dewelopera zostało zawieszone z powodu wielokrotnego naruszenia Warunków korzystania z usługi lub zasad dotyczących treści, odpowiedz na tego e-maila, jeśli potrzebujesz dodatkowych wyjaśnień.
Moja aplikacja została usunięta z Google Cast
Usunięcie aplikacji ma niekorzystny wpływ na opinię o koncie dewelopera. Powtarzające się lub rażące naruszenia zasad mogą skutkować zamknięciem konta dewelopera.
Usunięcie oznacza, że użytkownicy nie będą mogli wyświetlić usuniętej aplikacji ani uzyskać do niej dostępu. Jeśli Twoje konto dewelopera nadal ma w Google Cast dobrą opinię, a natura aplikacji na to pozwala, możesz wprowadzić poprawki i opublikować nową wersję aplikacji zgodną z zasadami.
Usuniętej aplikacji nie publikuj ponownie, dopóki nie usuniesz naruszenia zasad.
Chcę zmienić adres e-mail powiązany z moim kontem
Nie możesz zmienić adresu e-mail powiązanego z Twoim kontem dewelopera Google Cast. Jeśli pracujesz w organizacji, zalecamy używanie adresu e-mail zespołu, aby uniknąć problemów z dostępem w przyszłości.
Mam inny problem
Odwiedź stronę pomocy pakietu SDK Cast.