Jakość aplikacji TV

Użytkownicy mają inne oczekiwania, gdy oglądają telewizję, niż gdy korzystają z telefonu lub tabletu. Typowy użytkownik telewizora siedzi około 3 metrów od ekranu, więc drobne szczegóły są mniej zauważalne, a mały tekst jest trudny do odczytania. Użytkownicy siedzą w pewnej odległości od telewizora, więc do poruszania się po ekranie i wybierania elementów muszą używać pilota, a nie dotykać ekranu. Te różnice znacząco wpływają na wymagania dotyczące tego, co zapewnia dobre wrażenia użytkownika na telewizorze.

Pierwszym krokiem do stworzenia świetnych wrażeń dla użytkowników telewizorów jest zapoznanie się ze wskazówkami dotyczącymi projektowania na Androida TV i stosowanie się do nich. Aby poznać podstawowe wymagania dotyczące implementacji aplikacji TV, zapoznaj się też ze szkoleniem Tworzenie aplikacji 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ę.

Dostępne są te poziomy pomocy:

Ikona poziomu 3 TV Ready

Poziom 3 – TV Ready

Twoja aplikacja spełnia podstawowe wymagania dotyczące działania na urządzeniach z systemem operacyjnym Android TV.

Ikona poziomu 2 zoptymalizowanego pod kątem telewizorów

Poziom 2 – zoptymalizowany pod kątem telewizorów

Aplikacja zapewnia bardziej spersonalizowane i płynniejsze działanie na urządzeniach z systemem operacyjnym Android TV.

Ikona telewizora poziomu 1 – zróżnicowane

Poziom 1 – TV Differentiated

Twoja aplikacja zapewnia użytkownikom najwyższą jakość i w pełni wykorzystuje zaawansowane możliwości systemu operacyjnego Android TV.

Poziom 3 – gotowość do wyświetlania na telewizorach

Typ Test Opis
Program uruchamiający TV-LM Po instalacji aplikacja wyświetla ikonę programu uruchamiającego Androida TV. Więcej informacji znajdziesz w sekcji Deklarowanie aktywności TV.
TV-LB Aplikacja wyświetla zarówno pełnowymiarowy baner o wymiarach 320 × 180 pikseli, jak i ikonę aplikacji o wymiarach co najmniej 160 × 160 pikseli (przy gęstości xhdpi) jako ikony programu uruchamiającego w Android TV Launcher. Więcej informacji znajdziesz w wytycznych dotyczących ikon aplikacji i banerów aplikacji na Androida TV.
TV-BN Baner uruchamiania aplikacji zawiera jej nazwę.
TV-LG Jeśli aplikacja jest grą, pojawia 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 TV.
Układ TV-LO Aplikacja obsługuje orientację poziomą bez pionowych pasów u góry i u dołu ekranu ani po bokach. W przypadku filmów w oryginalnym formacie paski muszą być czarne. 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 odcię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.
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 Funkcje poniżej. Więcej informacji znajdziesz w sekcji Nawigacja na telewizorze.
TV-DK Jeśli aplikacja wymaga kontrolera do gier, zgodnie z kryterium TV-GP, wszystkie funkcje są dostępne za pomocą standardowych klawiszy kontrolera do gier na Androida. Więcej informacji znajdziesz w artykule na temat przetwarzania naciśnięć przycisków na padzie do gier.
TV-DM Aplikacja nie wymaga, aby urządzenie do zdalnego sterowania miało przycisk Menu, który umożliwia dostęp do elementów sterujących interfejsu.
TV-DB Naciśnięcie przycisku Wstecz powoduje powrót do ekranu głównego Androida TV. Więcej informacji znajdziesz w artykule Zapewnianie odpowiedniego działania przycisku Wstecz.
TV-DL Jeśli aplikacja ma kanał telewizji na żywo zintegrowany 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 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ę pakietu Android SDK na 31 lub niższą przez ustawienie wartości minSdkVersion.
Plik manifestu TV-ML Manifest aplikacji ustawia typ intencji ACTION_MAIN na kategorię CATEGORY_LEANBACK_LAUNCHER. Więcej informacji znajdziesz w sekcji Deklarowanie aktywności TV.
TV-MT Plik manifestu aplikacji ustawia funkcję sprzętową android.hardware.touchscreen i inne wymienione w sekcji „Deklarowanie wymagań sprzętowych dotyczących telewizorów” jako niewymagane. Więcej informacji znajdziesz w artykule Deklarowanie wymagań sprzętowych dotyczących telewizorów.
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 instrukcje wizualne dotyczące 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, które nie są reklamami 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 są klikalne, niepełnoekranowe i nie są reklamami wideo, aplikacja nie pozwala na linkowanie do adresu URL.
TV-AA W przypadku reklam, które nie są reklamami wideo ani reklamami pełnoekranowymi i które można kliknąć, 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ć uruchomić przeglądarki.
Odtwarzanie multimediów TV-NP Jeśli aplikacja nadal odtwarza dźwięk po powrocie użytkownika do ekranu głównego lub przełączeniu się na inną aplikację, udostępnia opcje sterowania multimediami w interfejsie systemu (np. kartę lub powiadomienie), 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ć tych opcji sterowania multimediami, a film musi zostać wstrzymany, gdy użytkownik przełączy się z aplikacji.
TV-PA Jeśli aplikacja udostępnia opcje sterowania multimediami w interfejsie systemu, wybranie ich powoduje przejście do ekranu, na którym można wstrzymać odtwarzanie.
TV-PN Elementy dodane do funkcji „Oglądaj dalej” są zgodne ze wskazówkami dla deweloperów aplikacji.
Odtwarzanie multimediów TV-PC Naciśnięcie środkowego przycisku pada kierunkowego podczas odtwarzania filmu lub dźwięku powoduje wstrzymanie odtwarzania. Gdy odtwarzanie jest wstrzymane, naciśnięcie środkowego przycisku pada kierunkowego powoduje jego wznowienie. 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 multimedialne.
TV-PP Jeśli aplikacja odtwarza filmy lub muzykę, przełącza się między odtwarzaniem a wstrzymywaniem multimediów, gdy podczas odtwarzania zostanie wysłane kluczowe zdarzenie odtwarzania lub wstrzymania. Więcej informacji: KEYCODE_MEDIA_PLAY_PAUSE.
Tryb nieaktywny TV-BU Podczas aktywnego odtwarzania filmu zainicjowanego przez użytkownika aplikacja blokuje przejście urządzenia w tryb nieaktywny. Więcej informacji znajdziesz w artykule Tryb nieaktywny.
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 podczas odtwarzania muzyki wyświetla niestatyczne obrazy, takie jak teledyski lub zdjęcia.
Obraz w obrazie TV-IC Jeśli aplikacja korzysta z trybu obrazu w obrazie, ustawia odpowiednie metadane, aby sklasyfikować użycie tego trybu jako jeden z dozwolonych typów. Deklaruje 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ć nadmiernych zasobów, przejmować fokusu 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 sterujących interfejsu ani elementów nawigacyjnych. Aplikacje mogą udostępniać niektóre elementy sterujące bezpośrednio w oknie obrazu w obrazie.
TV-IE Włączenie trybu obrazu w obrazie wymaga wyraźnego i celowego działania użytkownika w aplikacji. Aplikacja nie włącza automatycznie trybu PiP (setAutoEnterEnabled ustawione na false), chyba że użytkownik prowadzi rozmowę.
TV-IS Jeśli tryb obrazu w obrazie jest wyłączony na urządzeniu, aplikacja nie może wyświetlać żadnego interfejsu umożliwiającego jego włączenie.
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 podczas 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 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 Optymalizowanie wykorzystania pamięci.
Google Play TV-G1 Korzystanie z pakietów Android App Bundle jest obowiązkowe w przypadku wszystkich nowych i dotychczasowych aplikacji TV w Sklepie Google Play.
TV-G2 Aplikacja musi spełniać wymagania opisane w Centrum zasad dla deweloperów w Google Play.
TV-G6 Od 1 sierpnia 2026 r. aplikacje TV muszą obsługiwać architekturę 32- i 64-bitową oraz spełniać wymagania dotyczące stron o rozmiarze 16 KB.
Strona z informacjami o aplikacji TV-G3 Funkcje aplikacji działają zgodnie z oczekiwaniami lub opisem na stronie aplikacji w Sklepie Google Play.
TV-G4 Przesłana aplikacja zawiera co najmniej 1 niezmodyfikowany zrzut ekranu w wysokiej rozdzielczości, który dokładnie przedstawia aktualne wrażenia użytkownika aplikacji TV.
Dane logowania TV-G5 W przypadku aplikacji, które wymagają zalogowania się, musisz podać w Konsoli Google Play dane logowania, aby umożliwić przetestowanie wrażeń użytkownika aplikacji. Więcej informacji znajdziesz w sekcji „Dostęp do aplikacji” w artykule Przygotowanie aplikacji do sprawdzenia.

Poziom 2 – zoptymalizowany pod kątem telewizorów

Typ Test Opis
Wydajność TV-BP Aplikacja zawiera profile podstawowe, które poprawiają ogólną wydajność, np. uruchamianie aplikacji i ograniczanie zacinania się.
UI TV-4K Aplikacja jest zgodna z rozdzielczością 4K, ponieważ zawiera komponenty o wysokiej rozdzielczości, w tym ikonę aplikacji, baner, karty treści i inne komponenty.
Połączenia TV-CT Jeśli aplikacja ma odpowiednik mobilny, który obsługuje przesyłanie, aplikacja TV integruje się z odbiornikiem Cast TV (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ą telefonu lub konta Google, co ułatwia ten proces.
TV-LC Aplikacja bezpiecznie przechowuje dane logowania użytkowników lub automatycznie loguje powracających użytkowników za pomocą uwierzytelniania opartego na tokenach lub metod bezpiecznego przechowywania. Znacznie ułatwia to korzystanie z usługi po wstępnej konfiguracji.
Głos TV-VS Aplikacja integruje funkcje wyszukiwania głosowego, aby umożliwić odkrywanie treści za pomocą języka naturalnego. Integracja pomaga użytkownikom wpisywać zapytania bez konieczności używania klawiatury ekranowej, zwłaszcza jeśli aplikacja korzysta z klawiatury niestandardowej, która nie obsługuje głosowego wprowadzania tekstu. Aplikacja może na przykład włączyć klawiaturę Gboard do wprowadzania głosowego lub wyświetlić przycisk mikrofonu obok pola tekstowego wyszukiwania, aby uruchomić rozpoznawanie głosu.
TV-VC Aplikacja integruje polecenia głosowe do odtwarzania i nawigacji przez wdrożenie MediaSession.
Kontrolery do gier TV-GF Gra w pełni obsługuje zarówno fizyczne kontrolery do gier, jak i wirtualne pady do gier.

Poziom 1 – TV Differentiated

Typ Test Opis
Zaangażowanie TV-EC Aplikacja przesyła za pomocą pakietu Engage SDK typy encji treści, aby użytkownicy mogli wznowić oglądanie, np. dokończyć przerwany film lub obejrzeć kolejny odcinek serialu.
TV-ER Aplikacja przesyła odpowiednie typy encji 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 prawidłowy tryb odtwarzania i uniknąć zakłóceń (np. 50 Hz w przypadku treści o częstotliwości 50 kl./s).
TV-TO Aplikacja obsługuje dotyk i kliknięcia, aby zapewnić zgodność z pilotami ze wskaźnikiem i ekranami dotykowymi. Komponenty interfejsu wyświetlają stan najechania, 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, co zapewnia lepsze wrażenia podczas słuchania. Aplikacja może na przykład używać kodeka IAMF.
Ułatwienia dostępu TV-AX Aplikacja zawiera ulepszone opcje ułatwień dostępu, takie jak audiodeskrypcje, wyświetlanie napisów (w tym preferowane style napisów i tryb wysokiego kontrastu), ogólny tryb interfejsu o wysokim kontraście, uproszczone tryby nawigacji i regulowaną szybkość odtwarzania. Świadczy o głębokim zaangażowaniu w zapewnianie inkluzywności, dzięki czemu wszyscy użytkownicy mogą korzystać z usługi premium w łatwy i przyjemny sposób.
AI TV-AI Aplikacja zawiera funkcje 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ół Sklepu Play skontaktuje się z Tobą, wysyłając wiadomość na adres e-mail podany na koncie Konsoli Google Play powiązanym z aplikacją.

Moja aplikacja jest kierowana na inne formaty niż tylko telewizory. Jeśli moja aplikacja nie spełnia wymagań dotyczących telewizorów, czy moja nowa lub zaktualizowana aplikacja będzie nadal widoczna w Google Play na innych urządzeniach?

Aktualizacje informacji o aplikacji w Google Play można opublikować tylko wtedy, gdy wszystkie zmiany zostaną zatwierdzone. Jeśli aktualizacja artefaktu przeznaczonego na konkretny format urządzenia blokuje dalsze aktualizacje informacji o aplikacji na inne urządzenia, takie jak telefony czy tablety, możesz usunąć ten artefakt, zastępując go pustym przesłaniem, 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 telewizorach?

Aplikacje, które spełniają wymagania dotyczące telewizorów, od razu pojawią się w Sklepie Play na telewizorach.

Notatki dotyczące zmian

Maj 2026 r.

  • Poziomy jakości aplikacji TV
    • Dodaliśmy kryteria jakości dotyczące aplikacji zoptymalizowanych pod kątem telewizorów (poziom 2) i aplikacji wyróżniających się na telewizorach (poziom 1), aby doprecyzować, jakie funkcje premium powinny mieć aplikacje na telewizory, oprócz spełniania minimalnych wymagań dotyczących przesyłania (poziom 3).
  • Szukaj

    • Usunięto kryterium TV-SB:

      Wyszukiwanie w aplikacji nie jest już wymagane, ponieważ zalecamy integrację z pakietem Engage SDK (TV-EC, TV-ER).

  • Zasady Google Play

    • Usunęliśmy kryterium TV-G7 i zaktualizowaliśmy kryterium TV-G6:

      Dodaliśmy strony o rozmiarze 16 KB do wymagań dotyczących architektury 64-bitowej.

Styczeń 2026

Grudzień 2025 r.

Listopad 2024 r.

Maj 2024 r.

  • Odtwarzanie multimediów

    • Zaktualizowano kryterium TV-NP:

      Zaktualizowaliśmy kryterium, aby dotyczyło tylko odtwarzania audio, a nie wideo. Zalecamy też wstrzymywanie odtwarzania filmu, gdy aplikacja działa w tle.