Wraz z Androidem 5.0 pojawia się Android TV, który obsługuje Google Cast. W tym dokumencie opisujemy, co musisz zrobić, by skonfigurować i przetestować aplikację Cast na Androidzie TV. Aplikacja Cast działa na Androidzie TV bez żadnych dodatkowych czynności. Jeśli tworzysz aplikację Cast po raz pierwszy, zapoznaj się z dokumentacją Google Cast i opracuj ją tak, by działała na urządzeniu Chromecast, a dopiero potem zaprojektuj ją i przetestuj na Androidzie TV.
Konfigurowanie do programowania
- Skonfiguruj urządzenie z Androidem TV:
- Połącz urządzenie z Androidem TV z siecią lokalną.
- Zaloguj się na swoje konto Google.
- W sekcji Ustawienia w wierszu Urządzenie wybierz Informacje.
- Przewiń w dół i kliknij kilka razy Kompilację, aż pojawi się okno z komunikatem „Jesteś teraz programistą”.
- Jeśli debugowanie USB:
- Podłącz kabel USB, ale nie podłączaj jeszcze jego głównej części do komputera.
- W wierszu Preferencje wybierz Opcje programisty, wybierz Debugowanie USB, a potem Wł.
- Wróć na ekran główny. Musisz to zrobić, aby zastosować wybrane przed chwilą ustawienia. Ustawienia będą obowiązywać, dopóki nie zresetujesz urządzenia do ustawień fabrycznych.
- Zarejestruj urządzenie z Androidem TV w konsoli programisty Google Cast SDK, postępując zgodnie z instrukcjami opisanymi w artykule Rejestracja urządzenia.
Debugowanie
Aby przetestować i debugować aplikację Web pickups na urządzeniu z Androidem TV, wykonaj te czynności:
- Zarejestruj urządzenie z Androidem TV i aplikację w konsoli programisty Google Cast SDK. Więcej informacji o rejestrowaniu urządzeń i aplikacji znajdziesz w artykule Rejestracja.
- Uruchom aplikację nadawcy i przesyłaj obraz na urządzenie z Androidem TV.
- Połącz się z urządzeniem z Androidem TV przez ADB zgodnie z opisem w artykule Korzystanie z narzędzia Android Debug Bridge.
- Na komputerze, którego używasz do programowania, otwórz okno przeglądarki Chrome i wejdź na stronę chrome://inspect.
- Kliknij link inspect (inspektuj), aby przenieść odbiornik internetowy do debugera.
Włącz rejestrowanie debugowania w konsoli zdalnego Chrome, wpisując ten tekst:
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
Więcej informacji znajdziesz w sekcji Debugowanie.
Wytyczne dotyczące zgodności z Androidem TV
Dostosowanie aplikacji Cast do Androida TV nie wymaga wiele pracy. Oto kilka rekomendacji i typowych błędów, których należy unikać, by zadbać o zgodność aplikacji z Androidem TV:
- Pamiętaj, że ciąg znaków klienta użytkownika zawiera zarówno ciąg „Android”, jak i „CrKey”. Niektóre witryny mogą przekierowywać do witryny tylko na urządzenia mobilne, ponieważ wykrywają etykietę „Android”. Nie zakładaj, że ciąg „Android” w ciągu klienta użytkownika zawsze oznacza użytkownika mobilnego.
- Stos multimediów Androida może pobierać dane przez przezroczysty plik GZIP. Upewnij się, że dane multimedialne mogą odpowiadać usłudze
Accept-Encoding: gzip. - Zdarzenia multimedialne HTML5 na Androidzie TV mogą być wywoływane w innych momentach niż w przypadku Chromecasta. Może to ujawnić problemy, które nie były widoczne w przypadku Chromecasta.
- Podczas aktualizowania multimediów używaj zdarzeń związanych z multimediami wywoływanych przez elementy
<audio>/<video>, takie jaktimeupdate,pauseiwaiting. Unikaj korzystania ze zdarzeń związanych z siecią, takich jakprogress,suspendistalled, ponieważ zwykle zależą one od platformy. - Konfigurując certyfikaty HTTPS witryny odbiornika Web, pamiętaj o uwzględnieniu pośrednich certyfikatów CA. Na stronie testowej Qualsys SSL możesz sprawdzić, czy zaufana ścieżka certyfikacji dla Twojej witryny zawiera certyfikat CA oznaczony jako „dodatkowe pobieranie”, strona może nie wczytywać się na platformach Android.
- Chromecast wyświetla stronę odbiornika internetowego na grafice 720p, a inne platformy Cast, w tym Android TV, mogą wyświetlać tę stronę w rozdzielczości 1080p. Upewnij się, że strona odbiornika internetowego skaluje się płynnie w różnych rozdzielczościach.
Korzystanie z Android Debug Bridge
Platforma Android TV jest obsługiwana przez wiele rodzajów urządzeń elektronicznych: telewizory, dekodery, konsole do gier i inne. Każdy z nich można skonfigurować w różny sposób. Jeśli masz problem z dostępem do zasobów systemu Android TV w interfejsie urządzenia, możesz użyć Android Debug Bridge (ADB), by uzyskać numer seryjny urządzenia na potrzeby rejestracji lub zdebugować aplikację. Więcej informacji znajdziesz na stronie Android Debug Bridge.
Używanie ADB przez Wi-Fi
Aby połączyć się z urządzeniem przez ADB przez sieć Wi-Fi:
- Na urządzeniu z Androidem TV włącz opcje programisty zgodnie z opisem w sekcji Konfigurowanie na potrzeby programowania.
- Sprawdź, czy komputer jest połączony z tą samą siecią co urządzenie z Androidem TV.
Otwórz terminal i wpisz:
adb connect Android TV device IP address:4321
Na komputerze otwórz terminal i wpisz polecenia ADB. Aby sprawdzić, czy połączenie zostało nawiązane i czy urządzenie z Androidem TV komunikuje się w sieci, użyj tego polecenia:
adb logcat
Używanie ADB z kablem USB
Aby połączyć urządzenie przez ADB przez złącze USB:
- Skonfiguruj urządzenie z Androidem TV na potrzeby programowania, jak opisano w artykule Konfigurowanie na potrzeby programowania.
- Podłącz główny koniec kabla USB do komputera.
- W oknie Zezwalaj na debugowanie USB? wybierz Zawsze zezwalaj z tego komputera i kliknij OK.
Na komputerze otwórz terminal i wpisz polecenia ADB. Aby sprawdzić, czy połączenie zostało nawiązane i czy urządzenie z Androidem TV komunikuje się w sieci, użyj tego polecenia:
adb logcat
Korzystanie z ADB przez TCP/IP
ADB działa bez kabla USB, przez TCP/IP, ale najpierw musisz uzyskać adres IP urządzenia z Androidem TV. Urządzenia, których dotyczy problem, nasłuchują automatycznie połączeń z portem ADB i można je podłączyć bez inicjowania portu. Standardowe urządzenia z Androidem TV nie nasłuchują automatycznie połączeń ADB. W przypadku tych urządzeń musisz najpierw połączyć się z ADB kablem USB i zainicjować port.
- Skonfiguruj urządzenie z Androidem TV na potrzeby programowania, jak opisano w artykule Konfigurowanie na potrzeby programowania.
- Na urządzeniu z Androidem TV w wierszu Urządzenie kliknij Sieć > Wi-Fi i wybierz połączoną sieć.
- Kliknij Informacje o stanie i zanotuj adres IP.
Jeśli Twoje urządzenie jest standardowym urządzeniem z Androidem TV przeznaczonym do sprzedaży detalicznej, wykonaj te czynności:
- Wykonaj czynności opisane w artykule Używanie ADB z użyciem kabla USB.
- Sprawdź, czy komputer jest połączony z tą samą siecią co urządzenie z Androidem TV.
Zainicjuj w terminalu port TCP/IP na komputerze, wpisując:
adb tcpip 5555
Odłącz kabel USB i wpisz w złączu:
adb connect Android TV device IP address:5555
Jeśli na Twoim urządzeniu jest problem z Androidem TV dewelopera, wykonaj te czynności:
- Sprawdź, czy komputer jest połączony z tą samą siecią co urządzenie z Androidem TV.
Otwórz terminal i wpisz:
adb connect Android TV device IP address:4321
Na urządzeniu z Androidem TV w oknie Zezwalaj na debugowanie USB? wybierz Zawsze zezwalaj z tego komputera i kliknij OK. Aby sprawdzić, czy połączenie zostało nawiązane i czy urządzenie z Androidem TV komunikuje się z siecią, użyj tego polecenia:
adb logcat