Listy kontrolne aplikacji na telewizory
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Użytkownicy chętnie korzystają z aplikacji na telewizory, gdy są one spójne, logiczne i przewidywalne.
Użytkownik powinien mieć możliwość poruszania się w aplikacji i po Androidzie TV bez utraty orientacji czy konieczności „resetowania” interfejsu i rozpoczynania od początku. Użytkownicy doceniają przejrzyste, kolorowe i funkcjonalne interfejsy, które sprawiają, że korzystanie z aplikacji jest przyjemne. Dzięki tym wskazówkom możesz utworzyć aplikację, która dobrze działa na Androidzie TV i spełnia oczekiwania użytkowników.
Te listy kontrolne obejmują główne aspekty tworzenia aplikacji i gier, aby zapewnić jak najlepsze wrażenia. Dodatkowe kwestie dotyczące tylko gier są omówione w sekcji Gry.
Kryteria, które kwalifikują aplikację na Androida TV do dystrybucji w Google Play, znajdziesz w artykule Jakość aplikacji na Androida TV.
Obsługa formatu telewizora
Te elementy listy kontrolnej dotyczą gier i aplikacji.
Projektowanie interfejsu
Te elementy listy kontrolnej dotyczą gier i aplikacji.
-
Aby określić orientację poziomą, ustaw wartość
android:screenOrientation="landscape"
.
-
Dostarcz odpowiednie zasoby układu na potrzeby trybu poziomego.
-
Zadbaj o to, aby tekst i elementy sterujące były wystarczająco duże, aby były widoczne z pewnej odległości.
-
Prześlij mapy bitowe i ikony w wysokiej rozdzielczości na potrzeby ekranów HDTV.
-
Upewnij się, że ikony i logo są zgodne ze specyfikacją Androida TV.
-
Dopuść przesłonięcie w układzie.
-
Podczas aktywnego odtwarzania multimediów zainicjowanego przez użytkownika nie blokować przejścia urządzenia w tryb nieaktywny.
-
Upewnij się, że każdy element interfejsu działa zarówno z krzydłem, jak i z kontrolerem gier. Zapoznaj się z artykułami Nawigacja na telewizorze i Zarządzanie sprzętem do telewizora.
-
Zmień obraz tła, gdy użytkownicy przeglądają treści.
-
Dostosuj kolor tła, aby pasował do Twojego brandingu w fragmentach Leanback.
-
Upewnij się, że interfejs użytkownika nie wymaga ekranu dotykowego. Zobacz Ekran dotykowy i Zadeklaruj, że ekran dotykowy nie jest wymagany.
-
Przestrzegaj wskazówek dotyczących skutecznego reklamowania.
-
Aby poprowadzić użytkownika przez serię decyzji, użyj interfejsu GuidedStep API z biblioteki Leanback.
wyszukiwanie i odkrywanie treści;
Te elementy listy kontrolnej dotyczą gier i aplikacji.
-
W polu wyszukiwania globalnego na Androidzie TV wyświetlaj wyniki wyszukiwania z aplikacji.
-
Podaj pola danych dotyczących telewizji, które mają być uwzględniane w wyszukiwaniu.
-
Upewnij się, że aplikacja wyświetla odkryte treści na ekranie z informacjami, który pozwala użytkownikowi natychmiast rozpocząć oglądanie.
Ekran główny telewizora
Te elementy listy kontrolnej dotyczą układu i treści ekranu głównego.
Kanały
- Podaj nazwę, która pasuje do treści na kanale. Nie używaj nazwy aplikacji jako nazwy kanału.
- Nie zmieniaj nazwy kanału, chyba że użytkownik w jakiś sposób z nim wejdzie w interakcję.
- Do każdego kanału dodaj odpowiednią ikonę. Ikona nie musi być ikoną Twojej aplikacji. Może to być logo marki związane z treściami na kanale.
- Upewnij się, że każdy kanał jest niepowtarzalny i nie naśladuje funkcji wiersza Odtwórz następny.
Na przykład zezwalanie użytkownikom na kontynuowanie oglądania filmu od miejsca, w którym przerwali, nie jest prawidłowym wykorzystaniem kanału.
Treści na kanałach
- Ogranicz każdy program na kanale do jednej treści. Program nie może zawierać kolekcji filmów.
- Nie używaj programów do wysyłania wiadomości promocyjnych ani reklam.
- Dodaj odpowiedni opis każdego programu i poprawnie zmapuj jego metadane. Na przykład ocena treści nie może być wyświetlana w miejscu, w którym powinien znajdować się tytuł.
- Nie przycinaj ani nie rozciągaj obrazów podglądu przedstawiających zawartość programu. Muszą one pasować do jednego z dostępnych współczynników proporcji.
- Rozpocznij odtwarzanie programu, gdy tylko użytkownik go wybierze.
Odtwórz następny
- Nie dodawaj treści do wiersza Odtwórz dalej, chyba że użytkownik w jakiś sposób z nimi wejdzie w interakcję. Możesz na przykład dodać kolejny odcinek serialu, który użytkownik obecnie ogląda, ale nie dodawać powiązanego, ale innego serialu, gdy użytkownik ukończy oglądanie obecnego.
- Ogranicz treści Play Next do tradycyjnych programów telewizyjnych, filmów lub wydarzeń. Nie dodawaj klipów do wiersza Następne.
Aplikacje do odtwarzania
Te punkty listy kontrolnej dotyczą aplikacji, które umożliwiają odtwarzanie multimediów.
Gry
Te elementy listy kontrolnej dotyczą gier.
-
Ustaw flagę
isGame
w pliku manifestu, aby gra była widoczna w sekcji gier na ekranie głównym.
-
Upewnij się, że obsługa kontrolera do gier nie zależy od przycisków Start, Select ani Menu. Nie wszystkie kontrolery mają te przyciski.
-
Użyj ogólnej grafiki pada bez logo konkretnego producenta, aby pokazać przypisanie przycisków do gry.
-
Sprawdź połączenie przez Ethernet i Wi-Fi.
-
zapewnić użytkownikom przejrzystą ścieżkę wyjścia z aplikacji;
Dystrybucja na Androida TV
Aby dowiedzieć się, jak rozpowszechniać aplikacje na Androida TV, zapoznaj się z szczegółowym przewodnikiem po publikowaniu aplikacji na telewizory w Google Play.
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-27 UTC."],[],[],null,["# TV apps checklists\n\nUsers enjoy the TV app experience when it is consistent, logical, and predictable.\nThey should be able to navigate within your app and throughout Android TV without getting lost or\nhaving to \"reset\" the UI and start over. Users appreciate clear, colorful, and functional interfaces\nthat make the experience magical. With these ideas in mind, you can create an app that fits nicely\nin Android TV and performs as users expect.\n\n\nThese checklists cover the main aspects of development for both apps and games\nto help ensure that your app provides the best possible experience. Additional considerations\nfor games only are covered in the [Games](#games) section.\n\n\nFor the criteria that qualify an Android TV app to be distributed through Google Play, see\n[TV app quality](/docs/quality-guidelines/tv-app-quality).\n\nTV form factor support\n----------------------\n\nThese checklist items apply to games and apps.\n\n- Identify the [main TV activity](/training/tv/get-started/create#tv-activity) with the [CATEGORY_LEANBACK_LAUNCHER](/reference/android/content/Intent#CATEGORY_LEANBACK_LAUNCHER) filter in the manifest.\n- Provide a [home screen banner](/training/tv/get-started/create#banner) for each language supported by your app, with the following characteristics:\n - Banner measures 320x180 px.\n - Banner resource is in the `drawables/xhdpi` directory.\n - Banner image includes localized text to identify the app.\n- Consider whether your app needs to prevent the device from entering [Ambient Mode](/training/tv/playback/ambient-mode). This is particularly relevant for media [playback apps](#playback-apps).\n- Don't [declare a requirement](/training/tv/get-started/hardware#declare-hardware-requirements) for hardware that might be unsupported.\n- Make sure your [permissions](/training/tv/get-started/hardware#hardware-permissions) don't imply hardware requirements.\n\nUser interface design\n---------------------\n\nThese checklist items apply to games and apps.\n\n- Specify activities with landscape orientation by setting `android:`[screenOrientation](/guide/topics/manifest/activity-element#screen)`=\"landscape\"`.\n- Provide appropriate [layout resources](/training/tv/playback/leanback/layouts#structure) for landscape mode.\n- Make sure that [text and controls](/training/tv/playback/leanback/layouts#visibility) are large enough to be visible from a distance.\n- Provide [high-resolution bitmaps and icons](/training/tv/playback/leanback/layouts#density-resources) for HDTV screens.\n- Make sure your icons and logo conform to Android TV specifications.\n- Allow for [overscan](/training/tv/playback/leanback/layouts#overscan) in your layout.\n- When actively playing user-initiated media playback, prevent the device from entering [Ambient Mode](/training/tv/playback/ambient-mode).\n- Make sure every UI element works with both D-pad and game controllers. See [TV navigation](/training/tv/get-started/navigation) and [Handle TV hardware](/training/tv/get-started/hardware#controllers).\n- Change the [background image](/training/tv/playback/leanback/browse#background) as users browse through content.\n- Customize the [background color](/training/tv/playback/leanback/card) to match your branding in Leanback fragments.\n- Make sure that your UI does not require a touchscreen. See [Touchscreen](/training/tv/get-started/hardware#no-touchscreen) and [Declare touchscreen not required](/training/tv/get-started/create#no-touchscreen).\n- Follow the [guidelines for effective advertising](/training/tv/playback/leanback/layouts#advertising).\n- To guide the user through a series of decisions, use the Leanback library's [guided step API](/training/tv/playback/leanback/guided-step).\n\nSearch and content discovery\n----------------------------\n\nThese checklist items apply to games and apps.\n\n- Provide [search results](/training/tv/discovery/searchable#provide) from your app in the Android TV global search box.\n- Provide TV-specific [data fields](/training/tv/discovery/searchable#columns) for search.\n- Make sure your app presents discovered content in a [details screen](/training/tv/discovery/searchable#details) that lets the user start watching the content immediately.\n\nTV home screen\n--------------\n\n\nThese checklist items apply to the layout and content of the [home screen](/training/tv/discovery/recommendations-channel).\n\n### Channels\n\n- Provide a meaningful name that represents the channel's content. Don't use your app's name as a channel name.\n- Don't change the channel name unless there is some interaction with the user.\n- Include an associated icon for each channel. The icon doesn't need to be your app's exact icon; it can be a branded representation of the content in the channel.\n- Make each channel unique, and don't mimic the functionality of the Play Next row. For example, letting users continue watching where they left off in a video is not a valid use for a channel.\n\n### Content in channels\n\n- Limit each program in a channel to a single piece of content. A program must not contain a collection of videos.\n- Don't use programs for promotional messages or ads.\n- Include a suitable description for each program, and map its metadata correctly. For example, the content rating must not appear where the title is expected.\n- Don't crop or stretch preview images representing program content. They must fit one of the available [aspect ratios](/training/tv/discovery/preview-videos).\n- Start playing a program as soon as the user selects it.\n\n### Play Next\n\n- Don't add content to the Play Next row unless the user has been interacting with it some way. For example, you can add the next episode in a series that the user is currently watching, but don't add a related but different series when the user completes the current series.\n- Limit Play Next content to traditional TV shows, movies, or events. Don't add clips to the Play Next row.\n\nPlayback apps\n-------------\n\nThese checklist items apply to apps that perform media playback.\n\n- [Register a media session](/guide/topics/media-apps/working-with-a-media-session) to inform the platform of media playback state and to let playback controls be delegated to the app.\n- Set the [`FLAG_KEEP_SCREEN_ON`](/reference/android/view/WindowManager.LayoutParams#FLAG_KEEP_SCREEN_ON) flag while video is playing on the screen to [prevent the\n device from entering standby or Ambient Mode during playback](/training/tv/playback/ambient-mode#preventing-ambient-mode).\n- Validate that media commands accurately expose metadata and control playback using [Media Controller Test](https://github.com/googlesamples/android-media-controller) and the [Media Session\n Validator](https://developers.google.com/cast/docs/android_tv_receiver/mediasession_validator).\n- Comply with the [Ambient mode-related quality\n guidelines.](/docs/quality-guidelines/tv-app-quality#ambient-mode) Ambient Mode keeps users quietly entertained between watch sessions and prevents screen burn in.\n- Profile your app's memory and make sure to check [`ActivityManager.isLowRamDevice()`](/reference/android/app/ActivityManager#isLowRamDevice()) for discovering low-RAM devices. For those devices, you must follow the requirements in the [Optimize memory usage guidelines](/training/tv/playback/memory).\n\nGames\n-----\n\nThese checklist items apply to games.\n\n- Set the `isGame` flag in the manifest so that your game appears in the games section of the [home screen](/training/tv/games#Launcher).\n- Make sure [game controller\n support](/training/tv/games#control) doesn't depend on the Start, Select, or Menu buttons. Not all controllers have these buttons.\n- Use a generic gamepad graphic, without specific controller branding, to show [game button mappings](/training/tv/games#control).\n- Check for both ethernet and Wi-Fi [connectivity](/training/basics/network-ops/reading-network-state).\n- Provide users with a clean way to [exit](/training/tv/games#exit) your app.\n\nDistribute to Android TV\n------------------------\n\n\nTo learn how to distribute to Android TV, see the\n[detailed guide for publishing TV apps on Google\nPlay](/training/tv/publishing/distribute)."]]