Użytkownicy mają różne oczekiwania, gdy oglądają telewizję, a gdy korzystają z telefonu lub tabletu. Typowy użytkownik telewizora siedzi około 3 m od ekranu, więc małe szczegóły są mniej widoczne, a mały tekst jest trudny do odczytania. Użytkownicy siedzą z dala od telewizora, więc do poruszania się po interfejsie i wybierania elementów muszą używać pilota, a nie dotykać ekranu. Te różnice mają znaczący wpływ na wymagania dotyczące tego, co zapewnia dobre wrażenia użytkownikom telewizora.
Pierwszym krokiem do zapewnienia użytkownikom telewizorów komfortu jest zapoznanie się z wytycznymi dotyczącymi projektowania aplikacji na Androida TV i ich przestrzeganie. Aby poznać podstawowe wymagania dotyczące implementacji aplikacji TV, zapoznaj się też ze szkoleniem Tworzenie aplikacji na telewizory.
Informacje o publikowaniu aplikacji na telewizory w Google Play znajdziesz w artykule Rozpowszechnianie aplikacji na Androida TV.
Listy kontrolne zgodności aplikacji TV
Listy kontrolne zgodności określają kryteria, które pomogą Ci ocenić poziom obsługi systemu operacyjnego Android TV przez Twoją aplikację.
Poziomy pomocy obejmują:
Poziom 3 – gotowość do wyświetlania w telewizji
Twoja aplikacja spełnia podstawowe wymagania dotyczące działania na urządzeniach z Androidem TV.
Poziom 2 – zoptymalizowany pod kątem telewizji
Aplikacja zapewnia bardziej spersonalizowane i bezproblemowe działanie na urządzeniach z Androidem TV OS.
Poziom 1 – zróżnicowane reklamy telewizyjne
Aplikacja zapewnia najwyższą jakość obsługi, w pełni wykorzystując zaawansowane funkcje systemu Android TV OS.
Poziom 3 – gotowość do wyświetlania na telewizorze
| Typ | Test | Opis |
|---|---|---|
| Program uruchamiający | TV-LM | Po instalacji aplikacja wyświetla ikonę programu uruchamiającego Androida TV. Więcej informacji znajdziesz w artykule Deklarowanie aktywności związanej z telewizorem. |
| TV-LB | Aplikacja wyświetla w programie uruchamiającym Androida TV zarówno pełnowymiarowy baner o wymiarach 320 x 180 pikseli, jak i ikonę aplikacji o wymiarach co najmniej 160 x 160 pikseli (przy gęstości xhdpi). Więcej informacji znajdziesz w wytycznych dotyczących ikony i banera aplikacji na Androida TV. | |
| TV-BN | Baner uruchamiania aplikacji zawiera nazwę aplikacji. | |
| TV-LG | Jeśli aplikacja jest grą, pojawi się w wierszu Gry w programie uruchamiającym Androida TV. Więcej informacji znajdziesz w artykule Wyświetlanie gry na ekranie głównym. | |
| TV-LS | Aplikacja działa prawidłowo i nie wyświetla komunikatów o błędach, w tym podczas instalacji, wczytywania i testowania. Więcej informacji znajdziesz w artykule Uruchamianie aplikacji na telewizor. | |
| Układ | TV-LO | Aplikacja obsługuje orientację poziomą bez pionowych pasków po bokach. W przypadku pasków w filmach w oryginalnym formacie używaj tylko czarnego koloru. Więcej informacji znajdziesz w artykule Tworzenie podstawowych układów telewizyjnych. |
| TV-OV | Aplikacja nie wyświetla żadnego tekstu ani funkcji, które są częściowo ucięte przez krawędzie ekranu. Więcej informacji znajdziesz w sekcji Overscan. | |
| TV-TR | Aplikacja nie zasłania częściowo innych aplikacji. Aplikacja wypełnia cały ekran i ma nieprzezroczyste tło. | |
| Nawigacja | TV-DP | Funkcje aplikacji są dostępne za pomocą 5-kierunkowego pada kierunkowego, chyba że aplikacja wymaga kontrolera do gier, jak określono w kryterium TV-GP w sekcji Kontrolery w tabeli Funkcjonalność poniżej. Więcej informacji znajdziesz w sekcji Nawigacja po telewizorze. |
| TV-DK | Jeśli aplikacja wymaga kontrolera do gier, zgodnie z kryterium TV-GP, wszystkie funkcje można obsługiwać za pomocą standardowych klawiszy kontrolera do gier na Androida. Więcej informacji znajdziesz w artykule Przetwarzanie naciśnięć przycisków na padzie do gier. | |
| TV-DM | Aplikacja nie wymaga, aby urządzenie zdalnego sterowania miało przycisk Menu umożliwiający dostęp do elementów sterujących interfejsu użytkownika. | |
| TV-DB | Naciśnięcie przycisku Wstecz powoduje powrót do ekranu głównego Androida TV. Więcej informacji znajdziesz w artykule Zapewnianie prawidłowego działania przycisku Wstecz. | |
| TV-DL | Jeśli aplikacja ma zintegrowaną transmisję telewizyjną na żywo na karcie Na żywo, spełnia wymagania dotyczące płynnego odtwarzania i bezpośredniego powrotu. Więcej informacji znajdziesz w sekcji Przycisk Wstecz. | |
| SDK | TV-PS | Oprócz spełnienia podstawowych wymagań dotyczących wydajności i stabilności aplikacja deklaruje obsługę powszechnie używanych urządzeń z Androidem TV, ustawiając minimalną wersję Android SDK na 31 lub niższą, czyli ustawiając wartość parametru minSdkVersion. |
| Plik manifestu | TV-ML | Manifest aplikacji ustawia typ intencji ACTION_MAIN na kategorię CATEGORY_LEANBACK_LAUNCHER. Więcej informacji znajdziesz w artykule Deklarowanie aktywności związanej z telewizorem. |
| TV-MT | W pliku manifestu aplikacji funkcja sprzętowa android.hardware.touchscreen i inne wymienione w sekcji „Deklarowanie wymagań sprzętowych dotyczących telewizora” są ustawione jako niewymagane. Więcej informacji znajdziesz w artykule Deklarowanie wymagań sprzętowych dotyczących telewizora. | |
| Kontrolery do gier | TV-GP | Jeśli aplikacja używa kontrolera do gier jako głównej metody wprowadzania danych, deklaruje odpowiednie wymaganie za pomocą tagu manifestu <uses-feature>. Więcej informacji znajdziesz w artykule Deklarowanie obsługi kontrolerów do gier. |
| TV-GC | Jeśli aplikacja zawiera wizualne instrukcje korzystania z kontrolerów do gier, nie zawierają one elementów marki i pokazują zgodny układ przycisków. Więcej informacji znajdziesz w artykule Obsługa kontrolerów w grach. | |
| Reklama | TV-AP | Aplikacja umożliwia interakcję z reklamami za pomocą przycisków na padzie kierunkowym. Więcej informacji znajdziesz w artykule Włączanie nawigacji za pomocą pada kierunkowego. |
| TV-AD | W przypadku reklam pełnoekranowych innych niż wideo aplikacja pozwala użytkownikowi na natychmiastowe zamknięcie reklamy za pomocą przycisków na padzie kierunkowym lub kontrolerze do gier. | |
| TV-AU | W przypadku reklam, które można kliknąć, ale nie są pełnoekranowe ani nie zawierają wideo, aplikacja nie pozwala na połączenie reklam z adresem URL. | |
| TV-AA | W przypadku reklam, które są klikalne, nie są pełnoekranowe ani nie są reklamami wideo, aplikacja nie zezwala na powiązanie reklam z inną aplikacją, która nie jest dostępna na urządzeniach telewizyjnych. | |
| Treść internetowa | TV-WB | W przypadku treści z internetu aplikacja musi używać tylko komponentów WebView. Aplikacja nie może próbować uruchamiać przeglądarki. |
| Odtwarzanie multimediów | TV-NP | Jeśli aplikacja nadal odtwarza dźwięk po powrocie użytkownika na ekran główny lub przełączeniu się na inną aplikację, wyświetla kartę „Co jest grane” w wierszu rekomendacji na ekranie głównym, aby użytkownicy mogli wrócić do aplikacji i sterować odtwarzaniem. Więcej informacji znajdziesz w artykule Wyświetlanie karty Co jest grane. Aplikacje wideo nie mogą używać karty „Co jest grane”, a odtwarzanie wideo musi zostać wstrzymane, gdy użytkownik przełączy się na inną aplikację. |
| TV-PA | Jeśli aplikacja udostępnia kartę Co jest grane, wybranie tej karty przenosi użytkownika na ekran, na którym może wstrzymać odtwarzanie. | |
| TV-PN | Elementy dodane do sekcji Następne do obejrzenia są zgodne z wytycznymi dotyczącymi tej sekcji dla deweloperów aplikacji. | |
| Odtwarzanie multimediów | TV-PC | Gdy film lub dźwięk jest odtwarzany, naciśnięcie środkowego przycisku pada kierunkowego wstrzymuje odtwarzanie. Gdy odtwarzanie jest wstrzymane, naciśnięcie środkowego przycisku pada kierunkowego wznawia odtwarzanie. Przyciski w lewo i w prawo na padzie kierunkowym służą odpowiednio do przewijania do przodu i do tyłu bieżącego utworu. Więcej informacji znajdziesz w artykule Zdarzenia związane z multimediami. |
| TV-PP | Jeśli aplikacja odtwarza treści wideo lub muzyczne, przełącza się między odtwarzaniem a wstrzymywaniem multimediów, gdy podczas odtwarzania zostanie wysłane zdarzenie klawisza odtwarzania lub wstrzymywania. Więcej informacji znajdziesz w sekcji KEYCODE_MEDIA_PLAY_PAUSE. |
|
| Tryb nieaktywny | TV-BU | Gdy trwa aktywne odtwarzanie filmu zainicjowane przez użytkownika, aplikacja blokuje przejście urządzenia w tryb nieaktywny. Więcej informacji znajdziesz w artykule Tryb otoczenia. |
| TV-BY | Gdy nie trwa zainicjowane przez użytkownika aktywne odtwarzanie filmu lub animacji, aplikacja nie blokuje przejścia urządzenia w tryb nieaktywny. | |
| TV-BA | Podczas odtwarzania samego dźwięku aplikacja nie blokuje przejścia urządzenia w tryb nieaktywny, chyba że w trakcie odtwarzania muzyki wyświetla dynamiczne obrazy, np. teledyski lub zdjęcia. | |
| PiP | TV-IC | Jeśli aplikacja korzysta z trybu obraz w obrazie, ustawia odpowiednie metadane, aby zaklasyfikować jego użycie do jednego z dozwolonych typów. Określa też tytuł i podtytuł, które dokładnie opisują, do czego służy ten PIP. Więcej informacji znajdziesz w artykule Wielozadaniowość na telewizorze. |
| TV-IP | W trybie obrazu w obrazie aplikacja nie wyświetla materiałów promocyjnych ani reklam, które nie są nieodłączną częścią źródła treści. | |
| TV-IQ | W trybie obrazu w obrazie aplikacja nie pogarsza działania innej aktywności na pełnym ekranie. Aplikacja nie powinna zużywać nadmiernej ilości zasobów, przejmować aktywności audio, zakłócać aktywnej sesji MediaSession ani żądać nieproporcjonalnej liczby sesji dekodera. | |
| TV-IH | W trybie obrazu w obrazie aplikacja nie wyświetla żadnych elementów interfejsu ani elementów, po których można się poruszać. Aplikacje mogą udostępniać niektóre elementy sterujące bezpośrednio w oknie PiP. | |
| TV-IE | Aby włączyć tryb obrazu w obrazie, użytkownik musi wykonać w aplikacji wyraźne i celowe działanie. Aplikacja nie włącza automatycznie trybu obrazu w obrazie (setAutoEnterEnabled ustawione na false), chyba że użytkownik prowadzi rozmowę. |
|
| TV-IS | Jeśli tryb obraz w obrazie jest wyłączony na urządzeniu, aplikacja nie może wyświetlać interfejsu umożliwiającego przejście do tego trybu. | |
| TV-IX | Aplikacja używa trybu obrazu w obrazie tylko do kontynuowania trwającej aktywności. Funkcja obrazu w obrazie nie zachęca użytkowników do powrotu do widoku pełnoekranowego aplikacji w trakcie trwania aktywności ani po jej zakończeniu. | |
| Pamięć | TV-ME | W przypadku urządzeń z małą ilością pamięci RAM (gdzie ActivityManager.isLowRamDevice() zwraca wartość true) maksymalne wykorzystanie pamięci (Anon+Swap + Graphics + File Memory) przez aplikację na pierwszym planie musi mieścić się w limitach (w tym w określonych mechanizmach pomiarowych i zastrzeżeniach) zdefiniowanych w artykule Optymalizacja wykorzystania pamięci. |
| Google Play | TV-G1 | Korzystanie z pakietów aplikacji na Androida jest obowiązkowe w przypadku wszystkich nowych i dotychczasowych aplikacji na telewizory w Sklepie Google Play. |
| TV-G2 | Aplikacja musi spełniać wymagania Centrum zasad dla deweloperów w Google Play. | |
| TV-G6 | Od 1 sierpnia 2026 r. aplikacje na telewizory muszą obsługiwać architektury 64-bitowe. | |
| TV-G7 | Od 1 sierpnia 2026 r. aplikacje TV muszą obsługiwać strony o rozmiarze 16 KB. | |
| Strona z informacjami o aplikacji | TV-G3 | funkcje aplikacji działają zgodnie z oczekiwaniami lub z opisem na stronie aplikacji w Sklepie Google Play; |
| TV-G4 | W ramach przesyłania aplikacji przesłano co najmniej 1 niezmieniony zrzut ekranu w wysokiej rozdzielczości, który dokładnie przedstawia aktualną wersję aplikacji TV. | |
| Dane logowania | TV-G5 | W przypadku aplikacji, które wymagają zalogowania się użytkownika, musisz podać dane logowania w Konsoli Google Play, aby można było przetestować pełną funkcjonalność aplikacji. Więcej informacji znajdziesz w sekcji Dostęp do aplikacji w artykule Przygotowanie aplikacji do sprawdzenia. |
Poziom 2. Zoptymalizowany pod kątem telewizji
| Typ | Test | Opis |
|---|---|---|
| UI | TV-4K | Aplikacja zawiera komponenty interfejsu w rozdzielczości 4K, w tym ikonę aplikacji. |
| Łączność | TV-CT | Jeśli aplikacja ma wersję mobilną, która obsługuje Cast, aplikacja TV integruje się z odbiornikiem Cast na telewizor (Cast Connect), aby umożliwić użytkownikom przesyłanie treści z telefonu lub tabletu na telewizor. |
| Zaloguj się | TV-LI | Interfejs logowania: użytkownicy mogą logować się za pomocą urządzenia mobilnego lub konta Google, co zapewnia płynne logowanie. |
| TV-LC | Aplikacja bezpiecznie przechowuje dane logowania użytkownika lub automatycznie loguje powracających użytkowników za pomocą uwierzytelniania opartego na tokenach lub bezpiecznych metod przechowywania. Znacznie ułatwia to korzystanie z usługi po wstępnej konfiguracji. | |
| Głos | TV-VS | Aplikacja ma funkcję wyszukiwania głosowego, która umożliwia odkrywanie treści w języku naturalnym. |
| TV-VC | Aplikacja obsługuje polecenia głosowe dotyczące odtwarzania i nawigacji. | |
| Wydajność | TV-BP | Aplikacja zawiera profile podstawowe, które poprawiają ogólną wydajność, np. uruchamianie aplikacji i ograniczanie zacinania się. |
Poziom 1 – telewizory wyróżniające się na tle konkurencji
| Typ | Test | Opis |
|---|---|---|
| Zaangażowanie | TV-EC | Aplikacja przesyła typy treści, które użytkownicy mogą wznowić, np. przerwany film lub kolejny odcinek serialu, za pomocą pakietu Engage SDK. |
| TV-ER | Aplikacja przesyła odpowiednie typy jednostek treści, aby umożliwić wyświetlanie rekomendacji za pomocą pakietu Engage SDK. | |
| Funkcje urządzenia | TV-PI | Aplikacja wybiera wstępnie ustawiony profil obrazu telewizora dla odpowiednich treści (profil kinowy dla filmów, niskie opóźnienie / wysoki kontrast dla transmisji sportowych na żywo lub gier). |
| TV-AO | Aplikacja płynnie reaguje na przełączanie wyjścia audio, wybierając najlepszy kanał audio dla obsługiwanych urządzeń wyjściowych (np.kanał stereo dla słuchawek lub 5. 1 dla głośników przestrzennych). | |
| TV-FR | Aplikacja obsługuje żądanie liczby klatek na sekundę, dzięki czemu wyświetlacz może przełączyć się na odpowiedni tryb odtwarzania i uniknąć drgań (np.50 Hz w przypadku treści o częstotliwości 50 klatek na sekundę). | |
| TV-TO | Aplikacja obsługuje dotyk i kliknięcie, co zapewnia zgodność z pilotami wskaźnikowymi i ekranami dotykowymi. Komponenty interfejsu wyświetlają stan po najechaniu kursorem, gdy kursor znajduje się nad komponentem, z którym można wejść w interakcję. Komponenty można klikać, a kontenery z możliwością przewijania można przewijać w pionie i poziomie. | |
| TV-SA | Aplikacja obsługuje dźwięk przestrzenny, który zapewnia wciągające wrażenia słuchowe. Na przykład aplikacja może używać kodeka IAMF. | |
| Kontrolery do gier | TV-GF | Gra w pełni obsługuje różne kontrolery. |
| Ułatwienia dostępu | TV-AX | Aplikacja ma ulepszone opcje ułatwień dostępu, takie jak audiodeskrypcja, wyświetlanie napisów (w tym preferowane style napisów i tryb wysokiego kontrastu), ogólny tryb interfejsu użytkownika o wysokim kontraście, uproszczone tryby nawigacji i regulowana szybkość odtwarzania. Wyraża głębokie zaangażowanie w zapewnianie inkluzywności, gwarantując najwyższą jakość, dostępność i przyjemność dla wszystkich. |
| AI | TV-AI | Aplikacja udostępnia funkcje wykorzystujące AppFunctions lub AI w aplikacji. |
Najczęstsze pytania
Jak dowiem się, że moja aplikacja nie spełnia wszystkich wymagań dotyczących urządzeń TV?
Jeśli Twoja aplikacja nie spełnia wymagań dotyczących użyteczności opisanych na tej stronie, zespół Google Play skontaktuje się z Tobą za pomocą adresu e-mail podanego na koncie Konsoli Google Play powiązanym z aplikacją.
Moja aplikacja jest kierowana na urządzenia inne niż telewizory. Jeśli moja aplikacja nie spełnia wymagań dotyczących urządzeń TV, czy nowa lub zaktualizowana aplikacja będzie nadal widoczna w Google Play na innych urządzeniach?
Aktualizacje informacji o aplikacji w Google Play można publikować tylko wtedy, gdy wszystkie zmiany zostaną zatwierdzone. Jeśli aktualizacja artefaktu dla konkretnego typu urządzenia blokuje dalsze aktualizacje informacji o aplikacji na innych urządzeniach, takich jak telefony czy tablety, możesz usunąć ten artefakt, zastępując go pustym zgłoszeniem, dopóki nie spełnisz wymagań.
Jeśli moja aplikacja spełnia wymagania dotyczące publikowania, kiedy będzie dostępna w Sklepie Google Play na urządzeniach z Androidem TV?
Aplikacje spełniające wymagania dotyczące telewizorów będą od razu widoczne w Sklepie Play na urządzeniach z Androidem TV.
Opis zmian
Maj 2026 r.
- Poziomy jakości aplikacji na telewizory
- Dodaliśmy kryteria jakości zoptymalizowanej pod kątem telewizorów (poziom 2) i wyróżniającej się na telewizorach (poziom 1), aby wyjaśnić, co oznacza wysoka jakość na telewizorach w porównaniu z minimalnymi wymaganiami dotyczącymi przesyłania (poziom 3).
Szukaj
Styczeń 2026
Zasady Google Play
Nowe kryterium,
TV-G6:Od 1 sierpnia 2026 r. aplikacja musi obsługiwać architektury 64-bitowe.
Nowe kryterium,
TV-G7:Od 1 sierpnia 2026 r. Twoja aplikacja musi obsługiwać strony o rozmiarze 16 KB.
Grudzień 2025 r.
Oczekiwana wydajność
Nowe kryterium,
TV-PS:Oprócz podstawowych wymagań dotyczących wydajności i stabilności aplikacja musi obsługiwać powszechnie używane urządzenia z Androidem TV. W tym celu należy ustawić minimalną wersję pakietu Android SDK na 31 lub niższą.
Listopad 2024 r.
Funkcjonalność i wydajność
Nowe kryterium,
TV-ME:W przypadku urządzeń z małą ilością pamięci RAM (gdzie funkcja
ActivityManager.isLowRamDevice()zwraca wartośćtrue) maksymalne wykorzystanie pamięci (Anon+Swap + Graphics + File Memory) przez aplikację działającą na pierwszym planie musi mieścić się w limitach (w tym w określonych mechanizmach pomiarowych i zastrzeżeniach) zdefiniowanych w sekcji Optymalizacja wykorzystania pamięci.
Maj 2024 r.
Odtwarzanie multimediów
Zaktualizowane kryterium,
TV-NP:Kryterium zostało zaktualizowane, aby dotyczyło tylko odtwarzania dźwięku, a nie wideo. Zalecamy też wstrzymywanie odtwarzania filmu, gdy aplikacja działa w tle.