Rejestracja

Jeśli używasz stylizowanego odbiornika multimediów lub tworzysz niestandardowy odbiornik, musisz zarejestrować aplikację. Po zarejestrowaniu aplikacji otrzymasz identyfikator aplikacji, który jest używany przez aplikację nadawcy do wywoływania 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 stylizowanie interfejsu odtwarzacza multimediów i używa podanej stałej jako identyfikatora aplikacji.

Musisz też zarejestrować urządzenie Google Cast, aby mogło ono uzyskać dostęp do aplikacji odbiornika internetowego, zanim ją opublikujesz. Po opublikowaniu aplikacji odbiornika będzie ona dostępna na wszystkich urządzeniach Google Cast.

Aplikacje

Zarejestrowanie aplikacji umożliwia przetestowanie jej na zarejestrowanym urządzeniu Cast przed opublikowaniem. Opublikowanie aplikacji sprawia, że staje się ona dostępna na wszystkich urządzeniach Cast.

Rejestrowanie aplikacji

Musisz zarejestrować Styled Media Receiver lub Custom Receiver, aby otrzymać identyfikator aplikacji używany w wywołaniach interfejsu API z aplikacji nadawcy.

Aby zarejestrować aplikację Cast:

  1. Zaloguj się w Konsoli programisty Google Cast SDK.
  2. Na stronie Przegląd lub Aplikacje kliknij Dodaj nową aplikację.
  3. Wybierz typ aplikacji odbiornika internetowego, której będziesz używać:

    • Niestandardowy odbiornik

      Wybierz tę opcję, jeśli aplikacja wymaga komponentów interfejsu lub wzorców interakcji, których nie zapewnia Styled Media Receiver. Wybór niestandardowego odbiornika może być też konieczny, jeśli Twój typ treści nie jest wymieniony jako jeden z obsługiwanych typów multimediów w przypadku stylizowanego odbiornika multimediów.

      Pamiętaj, że ta opcja wymaga utworzenia kompletnej aplikacji internetowej na potrzeby aplikacji odbiornika internetowego.

      Szczegółowe informacje znajdziesz w artykule Custom Receiver Application (Niestandardowa aplikacja odbiornika).

    • Styled Media Receiver

      Wybierz tę opcję, jeśli Twoja aplikacja przesyła strumieniowo treści wideo lub audio przy użyciu jednego z obsługiwanych typów multimediów i chcesz udostępnić na telewizorze interfejs użytkownika, który korzysta z domyślnego interfejsu odtwarzacza multimedialnego lub zestawu niestandardowych stylów nałożonych na domyślny interfejs odtwarzacza multimedialnego.

      Style niestandardowe, które możesz podać, pozwalają określić wygląd różnych elementów interfejsu odtwarzacza (takich jak ekran powitalny i pasek postępu) przez podanie pliku CSS – nie musisz tworzyć aplikacji odbiornika.

      Więcej informacji znajdziesz w artykule Styled Media Receiver (w języku angielskim).

  4. Podaj szczegóły aplikacji odbiornika internetowego:

    1. W polu Nazwa wpisz nazwę aplikacji.

      Jest to nazwa aplikacji, która pojawia się podczas ładowania odbiornika internetowego lub w stanie bezczynności, jeśli używasz odbiornika multimediów w stylu aplikacji. Jeśli używasz niestandardowego odbiornika, wartość tego pola jest domyślną wartością stanu aplikacji, o ile nie została ustawiona za pomocą metody setApplicationState.

    2. Określ wygląd aplikacji odbiornika internetowego:

      • W przypadku odbiornika niestandardowego w polu URL podaj adres URL aplikacji.

        Wpisz adres URL, o który urządzenie Google Cast powinno wysłać żądanie podczas wczytywania aplikacji odbiornika internetowego. Podczas tworzenia aplikacji adres URL może używać protokołu HTTP, ale po opublikowaniu aplikacji musi używać protokołu HTTPS. Adres URL może prowadzić do strony HTML lub innego typu pliku dostępnego w przeglądarce. Odbiornik internetowy może mieć wewnętrzny adres IP (zarejestrowany w NAT), ale nie może być na hoście lokalnym, ponieważ rzadko jest to domena najwyższego poziomu. Chociaż opublikowana aplikacja odbiornika internetowego musi być obsługiwana przez SSL (HTTPS), treści wczytywane w aplikacji odbiornika internetowego mogą być obsługiwane przez HTTP.

      • W przypadku Styled Media Receiver w polu Skin URL (Adres URL skórki) podaj adres URL arkusza stylów.

        Podaj adres URL HTTPS, który wskazuje plik CSS znajdujący się w Twojej witrynie. Aby użyć stylów domyślnych, pozostaw to pole puste. Możesz je później edytować, jeśli chcesz podać lub zaktualizować style niestandardowe.

      • Zaznacz lub pozostaw niezaznaczone pole wyboru Obsługuje przesyłanie przekaźnikowe.

        Przesyłanie przez przekaźnik umożliwia odbiornikowi internetowemu obsługę przesyłania z urządzeń, które nie są połączone z tą samą siecią Wi-Fi co odbiornik. Aby wyłączyć przesyłanie przez przekaźnik na odbiorniku, odznacz to pole.

      • Zaznacz lub pozostaw niezaznaczone pole wyboru Obsługuje przesyłanie na urządzenia odtwarzające tylko dźwięk.

        Aby zezwolić aplikacji na wykrywanie urządzeń audio Google Cast, zaznacz to pole. Aby wyłączyć obsługę urządzeń tylko z dźwiękiem, odznacz to pole. Więcej informacji znajdziesz w sekcji Urządzenia audio.

  5. Kliknij Zapisz.

    Wyświetlą się szczegóły rejestracji, w tym identyfikator aplikacji, nazwa, typ i stan. Zapisz identyfikator aplikacji, ponieważ będziesz go podawać w wywołaniach interfejsu Cast API aplikacji.

  6. 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:

  1. W Konsoli programisty Google Cast SDK na stronie Przegląd lub Aplikacje kliknij Identyfikator aplikacji lub Edytuj obok aplikacji, którą chcesz edytować.
  2. W polu Nazwa zaktualizuj nazwę podaną podczas rejestracji aplikacji.
  3. W przypadku aplikacji z odbiornikiem niestandardowym w polu URL zaktualizuj lokalizację zarejestrowanej aplikacji z odbiornikiem internetowym.
  4. W przypadku aplikacji Styled Receiver w polu Skin URL (Adres URL skórki) zaktualizuj lokalizację arkusza stylów aplikacji.
  5. Zaznacz lub pozostaw niezaznaczone pole wyboru Obsługuje przesyłanie przekaźnikowe.

    Przesyłanie przez przekaźnik umożliwia odbiornikowi internetowemu obsługę przesyłania z nadawców, którzy nie są połączeni z tą samą siecią Wi-Fi co odbiornik. Aby wyłączyć przesyłanie przekaźnikowe na odbiorniku, odznacz to pole.

  6. Zaznacz lub pozostaw niezaznaczone pole wyboru Obsługuje przesyłanie na urządzenia audio.

    Aby umożliwić aplikacji wykrywanie urządzeń audio Google Cast, zaznacz to pole. Aby wyłączyć obsługę urządzeń tylko z dźwiękiem, odznacz to pole. Więcej informacji znajdziesz w sekcji Urządzenia audio.

  7. W sekcji Dane nadawcy podaj te informacje dotyczące każdej platformy obsługiwanej przez aplikację:

    • Android:

      • pełna i jednoznaczna nazwa pakietu aplikacji.
    • iOS:

      • identyfikator iTunes i identyfikator pakietu wymagane przez Apple.
      • Identyfikator URI uruchamiania aplikacji, używając identyfikatora URI, którego aplikacja Google Home używa do uruchamiania Twojej aplikacji. Więcej informacji o wymaganym formacie identyfikatora URI znajdziesz w artykule Using URL Schemes to Communicate with Apps (Używanie schematów adresów URL do komunikacji z aplikacjami).
    • W przeglądarce:

      • adres URL witryny aplikacji.
  8. W sekcji Szczegóły informacji wybierz, czy chcesz umieścić aplikację w usługach Google, takich jak chromecast.com/apps.

  9. W menu Kategoria wybierz kategorię, która najlepiej opisuje Twoją aplikację.

    Uwaga: aplikacja musi obsługiwać typy multimediów opisane tutaj, a także te, które wynikają z innych ustawień. Jeśli na przykład Twoja aplikacja obsługuje Google Cast w przypadku dźwięku i wybierzesz tutaj Telewizja i filmy, aplikacja musi obsługiwać urządzenia tylko do odtwarzania dźwięku, zgodnie z opisem w sekcji Urządzenia audio, a także postanowienia dotyczące odtwarzania filmów.

  10. Aby określić kraje, w których aplikacja jest dostępna, wybierz opcję Wszystkie kraje lub Tylko w wybranych krajach. Jeśli wybierzesz tę drugą opcję, zaznacz pola obok odpowiednich krajów na wyświetlonej liście.

  11. W polu Tytuł wpisz opisowy tytuł aplikacji.

    Użyj maksymalnie 50 znaków. Na przykład „YouTube”.

  12. W polu Opis wpisz opis aplikacji.

    Wpisz maksymalnie 80 znaków. Na przykład: „Oglądaj ulubione kanały YouTube na najlepszym ekranie w domu”.

  13. W sekcji Grafika kliknij znak plusa, aby przesłać obraz ikony aplikacji.

    Obraz musi mieć wymiary 512 x 512 pikseli i może mieć przezroczyste tło.

  14. Jeśli chcesz dodać tłumaczenia pól Tytuł i Opis, w sekcji Teraz Ty wybierz język z menu, kliknij Dodaj i wpisz przetłumaczony tekst w wyświetlonym oknie. Możesz też przesłać obraz ikony dla danego tłumaczenia.

  15. Po zaktualizowaniu informacji o aplikacji kliknij Zapisz.

Opublikuj aplikację

Opublikowanie aplikacji sprawia, że jest ona dostępna na wszystkich urządzeniach Cast na całym świecie. Tworzy też informacje o aplikacji w usługach Google, takich jak witryna chromecast.com/apps, gdzie użytkownicy mogą znaleźć i pobrać Twoją aplikację. Jeśli w kroku 6 powyżej podczas edytowania informacji o aplikacji wybierzesz opcję wyświetlania jej na liście, po opublikowaniu pojawi się ona na stronie chromecast.com/apps.

Aby opublikować aplikację:

  1. 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 o aplikacji wprowadzonymi w sekcji Edytowanie informacji o aplikacji. Jeśli nie, pojawi się komunikat z informacją, co musisz podać.

  2. Możesz kliknąć Edytuj, aby wrócić i zaktualizować informacje.

  3. Jeśli aplikacja jest gotowa do opublikowania, kliknij Opublikuj.

Statystyki

Konsola programisty Google Cast SDK śledzi wydajność aplikacji. W przypadku każdej opublikowanej aplikacji na stronie Aplikacje lub Przegląd możesz wyświetlić dane o skuteczności, 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 pojawia się platforma Inna, oznacza to, że nadawca nie wskazał swojej platformy, np. jeśli starszy nadawca iOS 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 programowania i testowania. Aby przekształcić urządzenie w urządzenie deweloperskie i uzyskać dostęp do nieopublikowanej aplikacji odbiornika internetowego podczas jej tworzenia, musisz zarejestrować urządzenie w aplikacji. Rejestracja umożliwia też dostęp do odbiornika ze zdalnego okna przeglądarki na potrzeby debugowania (patrz Debugowanie).

Aby zarejestrować urządzenie Google Cast:

  1. Skonfiguruj urządzenie Google Cast i połącz je z tą samą siecią Wi-Fi co komputer.

    Więcej informacji znajdziesz w instrukcjach konfiguracji urządzenia Cast.

  2. Na komputerze otwórz przeglądarkę obsługującą przesyłanie.

  3. Zaloguj się w Konsoli programisty Google Cast SDK.

  4. Znajdź numer seryjny urządzenia, które chcesz zarejestrować.

  5. Na stronie Przegląd lub Urządzenia kliknij Dodaj nowe urządzenie.

  6. Wpisz numer seryjny urządzenia.

  7. Wpisz opis i kliknij OK.

    To jest tylko przyjazna nazwa urządzenia (nie musi być taka sama jak nazwa nadana urządzeniu podczas konfiguracji użytkownika).

  8. Zanim przejdziesz dalej, odczekaj 15 minut.

    Po zakończeniu rejestracji stan urządzenia zmieni się na „Gotowe do testowania”.

  9. Uruchom ponownie urządzenie Cast: odłącz kabel zasilający lub USB od urządzenia, a następnie podłącz go ponownie.

Znajdowanie numeru seryjnego urządzenia

Aby znaleźć numer seryjny dowolnego urządzenia, możesz przesłać na nie stronę konsoli Cast Developer Console:

  1. Kliknij przycisk Cast (tak jakbyś przesyłał tę stronę).

    Pojawi się komunikat Przesyłanie karty i lista dostępnych urządzeń.

  2. Z menu wybierz urządzenie, którego numer seryjny chcesz uzyskać.

    • W przypadku urządzeń z wyświetlaczem numer seryjny jest wyświetlany na ekranie telewizora i odczytywany na głos przez głośniki telewizora (aby ułatwić odróżnienie cyfry 0 od litery O).
    • W przypadku urządzeń audio numer seryjny jest odczytywany na głos przez głośnik, na który przesyłasz treści.

Numer seryjny oprogramowania Android TV

Urządzenia z Androidem TV (ATV) mają powiązanych kilka numerów seryjnych. Numer seryjny oprogramowania (Cast) można uzyskać, przesyłając stronę konsoli Cast Developer Console na urządzenie ATV w sposób opisany powyżej lub przełączając urządzenie ATV w tryb programisty i szukając numeru seryjnego oprogramowania w ustawieniach Cast.

Aby przełączyć urządzenie ATV w tryb programisty, kliknij Ustawienia > System > Informacje > Kompilacja systemu operacyjnego Android TV i kliknij kompilację kilka razy, aż urządzenie powiadomi Cię, że jesteś w trybie programisty. Aby znaleźć numer seryjny w trybie programisty, otwórz Ustawienia > Ustawienia urządzenia > Google Cast lub Ustawienia > System > Przesyłaj, w zależności od modelu ATV. Zobaczysz numer seryjny oprogramowania.

Pamiętaj, że po przywróceniu urządzenia z Androidem TV do ustawień fabrycznych numer seryjny oprogramowania ulegnie zmianie. Po przywróceniu ustawień fabrycznych wykonaj czynności opisane powyżej, aby znaleźć numer seryjny oprogramowania i ponownie zarejestrować nowy numer seryjny oprogramowania urządzenia w Konsoli Cast dla programistów.

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 wysłaliśmy do Ciebie e-maila z informacją, że Twoje konto dewelopera zostało zawieszone z powodu wielokrotnego naruszenia naszych Warunków korzystania z usługi lub Polityki treści, odpowiedz na tę wiadomość, jeśli potrzebujesz dodatkowych wyjaśnień.

Moja aplikacja została usunięta z Google Cast

Usunięcie aplikacji jest traktowane jako ostrzeżenie i niekorzystnie wpływa na opinię o koncie dewelopera. Powtarzające się lub rażące naruszenia zasad mogą doprowadzić do zamknięcia konta dewelopera.

Usunięcie oznacza, że użytkownicy nie będą mogli wyświetlać usuniętej aplikacji ani uzyskiwać do niej dostępu. Jeśli Twoje konto dewelopera nadal ma w Google Cast dobrą opinię, a aplikacja na to pozwala, możesz wprowadzić poprawki i opublikować jej nową wersję zgodną ze wszystkimi wymaganiami.

Nie publikuj ponownie usuniętej aplikacji, 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 kontem dewelopera Google Cast. Jeśli pracujesz w organizacji, zalecamy użycie adresu e-mail zespołu, aby uniknąć problemów z dostępem w przyszłości.

Mam inny problem

Odwiedź stronę pomocy Cast SDK.