Checklists voor tv-apps

Gebruikers vinden de tv-app prettig als deze consistent, logisch en voorspelbaar is. Ze moeten in je app en in Android TV kunnen navigeren zonder verdwaald te raken of de UI te resetten en opnieuw te beginnen. Gebruikers stellen heldere, kleurrijke en functionele interfaces op prijs die een magische beleving bieden. Op basis hiervan kun je een app maken die goed in Android TV past en presteert zoals gebruikers verwachten.

Deze checklists omvatten de belangrijkste ontwikkelingsaspecten voor zowel apps als games om te zorgen dat je app de best mogelijke functionaliteit biedt. Aanvullende overwegingen voor games worden alleen behandeld in het gedeelte Games.

Raadpleeg de kwaliteitsrichtlijnen voor tv-apps voor de criteria die gelden voor distributie van Android TV-apps via Google Play.

Ondersteuning voor tv-vormfactor

Deze checklist-items zijn van toepassing op games en apps.

Identificeer de belangrijkste tv-activiteit met het filter CATEGORY_LEANBACK_LAUNCHER in het manifest.
Lever een banner op het startscherm voor elke taal die door je app wordt ondersteund, met de volgende kenmerken:
- De banner heeft een afmeting van 320 x 180 pixels.
- De bannerresource bevindt zich in de directory drawables/xhdpi.
- De bannerafbeelding bevat gelokaliseerde tekst om de app te identificeren.
Ga na of je app moet voorkomen dat het apparaat de Sfeermodus activeert. Dit is met name relevant voor apps die media afspelen.
Definieer geen vereiste voor hardware die misschien niet wordt ondersteund.
Zorg dat je rechten geen hardwarevereisten impliceren.

Ontwerp van de gebruikersinterface

Deze checklist-items zijn van toepassing op games en apps.

Geef activiteiten in de liggende stand op door android:screenOrientation="landscape" in te stellen.
Lever geschikte indelingsresources aan voor de liggende modus.
Zorg dat tekst en bedieningselementen groot genoeg zijn om op een afstand zichtbaar te zijn.
Lever bitmaps en iconen met een hoge resolutie aan voor HDTV-schermen.
Zorg dat je iconen en logo voldoen aan de Android TV-specificaties.
Sta overscan toe in je indeling.
Als door de gebruiker gestarte media wordt afgespeeld, moet je voorkomen dat het apparaat overschakelt naar de Sfeermodus.
Zorg dat elk UI-element werkt met zowel D-pad- als gamecontrollers. Zie Tv-navigatie en Tv-hardware verwerken.
Wijzig de achtergrondafbeelding terwijl gebruikers door content browsen.
Pas de achtergrondkleur aan zodat deze overeenkomt met je branding in Leanback-fragmenten.
Zorg dat er geen touchscreen is vereist voor je UI. Raadpleeg Touchscreen en Definiëren dat touchscreen niet vereist is.
Volg de richtlijnen voor effectief adverteren.
Gebruik de API met stapsgewijze stappen in de Leanback-bibliotheek om de gebruiker door een reeks beslissingen te leiden.

Zoeken en contentdetectie

Deze checklist-items zijn van toepassing op games en apps.

Bied zoekresultaten uit je app aan in het algemene zoekvak van Android TV.
Verstrek tv-specifieke gegevensvelden voor zoekopdrachten.
Zorg dat je app ontdekte content presenteert in een scherm met details waarop de gebruiker meteen kan beginnen met het bekijken van de content.

Startscherm van tv

Deze checklist-items zijn van toepassing op de indeling en content van het startscherm.

Kanalen

Voer een betekenisvolle naam in die de content van het kanaal vertegenwoordigt. Gebruik de naam van je app niet als kanaalnaam.
Verander de kanaalnaam alleen als er interactie met de gebruiker is.
Voeg een bijbehorend icoon toe aan elk kanaal. Het icoon hoeft niet het exacte icoon van je app te zijn. Het kan een merkrepresentatie van de content op het kanaal zijn.
Maak elk kanaal uniek en imiteer niet de functionaliteit van de rij Hierna afspelen. Als je gebruikers bijvoorbeeld verder laat kijken vanaf het punt waar ze gebleven waren in een video, wordt dit niet beschouwd als een geldig gebruik van het kanaal.

Content in kanalen

Beperk elk programma in een kanaal tot één soort content. Een programma mag geen collectie video's bevatten.
Gebruik geen programma's voor promotieberichten of advertenties.
Neem voor elk programma een geschikte beschrijving op en wijs de metadata correct toe. De contentclassificatie mag bijvoorbeeld niet worden weergegeven waar de titel wordt verwacht.
Snijd geen voorbeeldafbeeldingen van programmacontent bij of rek deze niet uit. Ze moeten in een van de beschikbare beeldverhoudingen passen.
Speel een programma af zodra de gebruiker het selecteert.

Hierna afspelen

Voeg geen content toe aan de rij Hierna afspelen, tenzij de gebruiker er op een of andere manier interactie mee heeft gehad. Je kunt bijvoorbeeld de volgende aflevering toevoegen in een serie die de gebruiker op dat moment bekijkt, maar voeg geen gerelateerde, andere serie toe wanneer de gebruiker de huidige serie afrondt.
Beperk content van het type Hierna afspelen tot traditionele tv-series, films of evenementen. Voeg geen fragmenten toe aan de rij Hierna afspelen.

Apps die media afspelen

Deze checklist-items zijn van toepassing op apps die media afspelen.

Registreer een mediasessie om het platform te informeren over de afspeelstatus van media en om de afspeelbediening aan de app te delegeren.
Stel de flag FLAG_KEEP_SCREEN_ON in terwijl er een video wordt afgespeeld op het scherm om te voorkomen dat het apparaat tijdens het afspelen overschakelt naar stand-by of de Sfeermodus.
Controleer of mediaopdrachten de metadata en afspeelbediening nauwkeurig tonen met de Media Controller Test en de Validator voor mediasessies.
Zorg dat je voldoet aan de kwaliteitsrichtlijnen voor de sfeermodus. Met de sfeermodus kunnen gebruikers zich ontspannen tussen kijksessies en voorkomen dat hun scherm inbrandt.

Games

Deze checklist-items zijn van toepassing op games.

Stel de flag isGame in het manifest in zodat je game wordt weergegeven in het gedeelte Games van het startscherm.
Zorg dat de ondersteuning voor gamecontrollers niet afhankelijk is van de knoppen Start, Select of Menu. Niet alle controllers hebben deze knoppen.
Gebruik een algemene gamepad-afbeelding, zonder specifieke controllerbranding, om toewijzingen voor gameknoppen te tonen.
Check de ethernet- en wifi-verbinding.
Bied gebruikers een duidelijke manier om je app af te sluiten.

Distribueren naar Android TV

Raadpleeg de gedetailleerde gids voor het publiceren van tv-apps op Google Play voor informatie over distributie naar Android TV.