Jakość aplikacji TV

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 metrów 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ą istotny wpływ na wymagania dotyczące tego, co sprawia, że korzystanie z telewizora jest wygodne.

Pierwszym krokiem do zapewnienia użytkownikom telewizorów doskonałych wrażeń jest zapoznanie się z wytycznymi dotyczącymi projektowania aplikacji na Androida TV i ich przestrzeganie. Aby poznać podstawowe wymagania dotyczące implementacji aplikacji na telewizory, 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.

Projektowanie wizualne i interakcja z użytkownikiem

Poniższe kryteria pomagają zapewnić, że aplikacja jest zgodna z najważniejszymi wzorcami projektowania i interakcji, co przekłada się na spójne, intuicyjne i przyjemne wrażenia użytkowników na urządzeniach telewizyjnych.

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 × 180 pikseli, jak i ikonę aplikacji o wymiarach co najmniej 160 × 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

Wszystkie interfejsy aplikacji są wyświetlane w orientacji poziomej i bez pionowych pasków u góry i u dołu ekranu. W przypadku pasków w filmach w oryginalnym formacie można używać tylko koloru czarnego. Więcej informacji znajdziesz w artykule Tworzenie podstawowych układów na telewizor.

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.

TV-DP

Funkcje aplikacji można obsługiwać 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 można obsługiwać za pomocą standardowych klawiszy kontrolera do gier na Androida. Więcej informacji znajdziesz w sekcji 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.

TV-SB

W polu wyszukiwania pojawia się zapytanie w aplikacji, podobnie jak w interfejsie użytkownika udostępnianym przez SearchFragment, a wyniki są trafne w odniesieniu do tego zapytania. Więcej informacji znajdziesz w artykule Wyszukiwanie w aplikacjach na telewizor.

Funkcjonalność i wydajność

Te kryteria zapewniają, że aplikacja jest prawidłowo skonfigurowana i działa zgodnie z oczekiwaniami.

Typ Test Opis
Pakiet SDK TV-PS Oprócz spełnienia wymagań dotyczących podstawowej wydajności i stabilności aplikacja deklaruje obsługę powszechnie używanych urządzeń z Androidem TV, ustawiając minimalną wersję pakietu SDK Androida na 31 lub niższą, czyli ustawiając wartość 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 wyświetlają zgodny układ przycisków. Więcej informacji znajdziesz w artykule Obsługa kontrolerów w grach.

Reklamy 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 klikalnych, innych niż pełnoekranowe i innych niż wideo aplikacja nie pozwala na łą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ści internetowe TV-WB

W przypadku treści internetowych aplikacja może używać tylko WebViewkomponentów. 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 na ekran główny lub przełączeniu się na inną aplikację, w wierszu rekomendacji na ekranie głównym wyświetla się karta Teraz odtwarzane, dzięki czemu użytkownicy mogą wrócić do aplikacji i kontrolować odtwarzanie. Więcej informacji znajdziesz w artykule Wyświetlanie karty Co jest grane.

Zalecamy wstrzymywanie odtwarzania filmu, gdy użytkownik przełącza się na inną aplikację, i nieintegrowanie filmu z kartą Teraz odtwarzane.

TV-PA

Jeśli aplikacja udostępnia kartę Co jest grane, wybranie jej przenosi użytkownika na ekran, na którym może wstrzymać odtwarzanie.

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.

TV-PC

Podczas odtwarzania filmu lub dźwięku naciśnięcie środkowego przycisku pada kierunkowego wstrzymuje odtwarzanie. Gdy odtwarzanie jest wstrzymane, naciśnięcie środkowego przycisku pada kierunkowego wznawia odtwarzanie. Przyciski pada kierunkowego w lewo i w prawo przewijają odpowiednio do przodu i do tyłu bieżący utwór. Więcej informacji znajdziesz w artykule Zdarzenia związane z mediami.

TV-PN

Elementy są dodawane do kanału Obejrzyj następny na podstawie wytycznych dotyczących kanału Obejrzyj następny dla deweloperów aplikacji.

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 wyświetla dynamiczne obrazy, np. teledyski lub zdjęcia, podczas odtwarzania muzyki.

Pamięć
TV-ME

W przypadku urządzeń z małą ilością pamięci RAM (na których funkcja ActivityManager.isLowRamDevice() zwraca wartość „true”) maksymalne zużycie pamięci (Anon+SwapGraphicsFile Memory) aplikacji działającej na pierwszym planie musi mieścić się w limitach (wraz z określonymi mechanizmami pomiarowymi i zastrzeżeniami) zdefiniowanych w artykule Optymalizacja zużycia pamięci.

Google Play

Aby skonfigurować aplikację zgodnie z innymi informacjami i klasyfikacjami w Google Play, postępuj zgodnie z tymi wymaganiami:

Typ Test Opis
Obraz w obrazie TV-IC

Aplikacja ustawia odpowiednie metadane, aby zaklasyfikować użycie trybu obraz w obrazie do jednego z dozwolonych typów użycia. 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ć nadmiernej ilości zasobów, przejmować fokusu audio, zakłócać aktywnej sesji MediaSession ani żądać nieproporcjonalnej liczby sesji dekodera.

TV-IH

Aplikacja nie wyświetla żadnych elementów sterujących interfejsu ani elementów, po których można nawigować, w trybie obrazu w obrazie. 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 obrazu w obrazie (setAutoEnterEnabled ustawione na false), chyba że użytkownik prowadzi rozmowę.

TV-IS

Jeśli tryb obrazu w obrazie jest na urządzeniu wyłączony, aplikacja nie może wyświetlać interfejsu umożliwiającego włączenie 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 podczas trwania aktywności ani po jej zakończeniu.

Zasady Google Play TV-G1

Korzystanie z pakietów aplikacji na Androida jest obowiązkowe w przypadku wszystkich nowych i istniejących aplikacji na telewizory w Sklepie Google Play.

TV-G2

Aplikacja musi spełniać wymagania Centrum zasad dla deweloperów w Google Play.

Strona szczegółów aplikacji TV-G3

Funkcje aplikacji działają zgodnie z oczekiwaniami lub zgodnie 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 na telewizory.

Dane logowania TV-G5

W przypadku aplikacji z płatnymi funkcjami musisz podać dane logowania w Konsoli Google Play, aby umożliwić testowanie pełnej wersji aplikacji. Więcej informacji znajdziesz w sekcji Dostęp do aplikacji w artykule Przygotowanie aplikacji do sprawdzenia.

Najczęstsze pytania

Po przesłaniu aplikacji jak dowiem się, czy nie spełnia ona 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ą, wysyłając e-maila na adres podany na koncie Konsoli Google Play powiązanym z aplikacją.

Ostrzeżenie: upewnij się, że Twoja aplikacja zawiera wymagane wpisy w pliku manifestu dla urządzeń telewizyjnych. W przeciwnym razie aplikacja nie będzie uznawana za aplikację na telewizory i nie zostanie sprawdzona pod kątem wymagań dotyczących użyteczności na telewizorach.

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 opublikować 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, które spełniają wymagania dotyczące telewizorów, będą od razu widoczne w Sklepie Play na urządzeniach z Androidem TV.