Kwaliteitsrichtlijnen voor tv-apps

Gebruikers hebben andere verwachtingen als ze tv kijken dan wanneer ze een telefoon of tablet gebruiken. Een tv-gebruiker zit meestal ongeveer 3 meter van het scherm af, waardoor kleine details minder opvallen en kleine tekst moeilijk leesbaar is. Omdat gebruikers niet dicht genoeg in de buurt van hun tv zitten, moeten ze een afstandsbediening gebruiken om te navigeren en selecties te maken in plaats van op elementen op het scherm tikken. Deze verschillen hebben aanzienlijke invloed op de vereisten voor een goede gebruikerservaring met de tv.

De eerste stap op weg naar een goede gebruikerservaring voor tv-gebruikers is het doornemen en volgen van de ontwerprichtlijnen voor Android TV. Neem ook de training Tv-apps ontwerpen door voor meer informatie over de fundamentele implementatievereisten voor een tv-app.

Belangrijk: Apps voor tv's moeten aan specifieke vereisten voor gebruiksgemak voldoen om een goede gebruikerservaring te garanderen. Alleen apps die aan de kwaliteitscriteria op deze pagina voldoen, komen in aanmerking als Android TV-app op Google Play.

Ga naar Distribueren naar Android TV voor informatie over het publiceren van je tv-apps op Google Play.

Visueel ontwerp en gebruikersinteractie

De volgende criteria zorgen dat je app essentiële ontwerp- en interactiepatronen volgt voor een consistente, intuïtieve en aangename gebruikerservaring op tv's.

Type Test Beschrijving
Launcher TV-LM

De app geeft na de installatie een launcher-icoon weer in de Android TV Launcher. Ga voor meer informatie naar Een tv-activiteit definiëren.

TV-LB

De app toont een banner van volledig formaat van 320 x 180 pixels en een app-icoon van ten minste 160 x 160 pixels (met een dichtheid van xhdpi) als launcher-iconen in de Android TV Launcher. Raadpleeg de richtlijnen voor app-iconen en banners voor Android TV voor meer informatie.

TV-BN

De banner voor app-lancering bevat de naam van de app.

TV-LG

Als de app een game is, staat deze in de rij Games in de Android TV Launcher.
Ga voor meer informatie naar Je game op het startscherm tonen.

TV-LS

De app wordt zonder foutmeldingen uitgevoerd, waaronder tijdens installeren, laden en testen. Ga voor meer informatie naar Tv-apps uitvoeren.

Indeling TV-LO

Alle app-interfaces worden weergegeven in liggende stand, zonder verticale of horizontale zwarte balken. Er mag alleen een zwarte kleur worden gebruikt voor balken in video's met oorspronkelijke indeling. Ga voor meer informatie naar Basis-tv-indelingen maken.

TV-OV

De app geeft geen tekst of functionaliteit weer die gedeeltelijk wordt afgekapt door de randen van het scherm. Ga voor meer informatie naar Overscan.

TV-TR

De app verbergt andere apps niet gedeeltelijk. De app vult het hele scherm en heeft een niet-transparante achtergrond.

TV-DP

Je kunt navigeren in de app-functionaliteit met D-padbediening in 5 richtingen, tenzij de app een gamecontroller vereist, zoals gespecificeerd in het criterium TV-GP in het gedeelte Controllers van de tabel Functionaliteit hieronder. Ga voor meer informatie naar Tv-navigatie.

TV-DK

Als de app een gamecontroller vereist, zoals gespecificeerd in het criterium TV-GP, is alle functionaliteit navigeerbaar met de toetsen van een standaard Android-gamecontroller. Ga voor meer informatie naar Drukken op gamepad-knoppen verwerken.

TV-DM

De app heeft geen afstandsbediening met menuknop nodig om toegang te bieden tot de bedieningselementen van de gebruikersinterface.

TV-DB

Als je de terugknop indrukt, ga je terug naar het startscherm van Android TV. Ga voor meer informatie Geschikt gedrag voor de terugknop bieden.

TV-DL

Als de app een live tv-feed heeft die is geïntegreerd op het tabblad Live, voldoet de app aan de vereisten voor naadloos afspelen en direct terug. Ga voor meer informatie naar Terugknop.

TV-SB

In het zoekvak wordt een in-app zoekopdracht getoond, vergelijkbaar met de gebruikersinterface van SearchFragment. De resultaten zijn relevant voor die zoekopdracht. Ga voor meer informatie naar Zoeken in tv-apps.

Functionaliteit

Deze criteria zorgen dat je app correct is ingesteld en het verwachte functionele gedrag levert.

Type Test Beschrijving
Manifest TV-ML

Het app-manifest stelt een intentietype van ACTION_MAIN in met de categorie CATEGORY_LEANBACK_LAUNCHER. Ga voor meer informatie naar Een tv-activiteit definiëren.

TV-MT

Het app-manifest stelt de hardwarefunctie android.hardware.touchscreen en andere hardwarefuncties in de 'Hardwarevereisten voor tv definiëren' in op niet vereist. Ga voor meer informatie naar Hardwarevereisten voor tv definiëren.

Gamecontrollers TV-GP

Als de app een gamecontroller als primaire invoermethode gebruikt, wordt de juiste vereiste gedefinieerd met de manifesttag <uses-feature>. Ga voor meer informatie naar Ondersteuning voor gamecontrollers definiëren.

TV-GC

Als de app visuele instructies biedt voor het gebruik van gamecontrollers, bevatten de instructies geen branding en wordt een compatibele knopindeling getoond. Ga voor meer informatie naar Controllers voor games verwerken.

Advertenties TV-AP

De app biedt interactie met advertenties via de bedieningselementen van de D-pad. Ga voor meer informatie naar D-padnavigatie aanzetten.

TV-AD

In het geval van niet-videoadvertenties op volledig scherm kan de gebruiker de advertentie meteen sluiten via de bedieningselementen van de D-pad of gamepad.

TV-AU

In het geval van klikbare niet-videoadvertenties op niet-volledig scherm mag de app niet toestaan dat advertenties links naar een web-URL bevatten.

TV-AA

In het geval van klikbare niet-videoadvertenties op niet-volledig scherm mag de app niet toestaan dat advertenties links naar een andere app bevatten die niet beschikbaar is op tv's.

Webcontent TV-WB

Voor webcontent mag de app alleen WebView-componenten gebruiken. De app mag niet proberen een webbrowser-app te starten.

Media afspelen TV-NP

Als de app geluid of video blijft afspelen nadat de gebruiker terugkeert naar het startscherm of naar een andere app schakelt, wordt de kaart Now Playing in de aanbevelingsrij op het startscherm getoond, zodat gebruikers kunnen teruggaan naar de app om het afspelen te regelen. Ga voor meer informatie naar Een Now Playing-kaart weergeven.

TV-PA

Als de app een Now Playing-kaart toont en de gebruiker deze kaart selecteert, gaat de gebruiker naar een scherm waarop die het afspelen kan pauzeren.

TV-PP

Als de app video- of muziekcontent afspeelt, schakelt de app tussen het afspelen en pauzeren van media als er tijdens het afspelen een belangrijke gebeurtenis wordt verstuurd. Ga voor meer informatie naar KEYCODE_MEDIA_PLAY_PAUSE.

TV-PC

Als je tijdens het afspelen van een video of audio op de middelste knop van de D-pad drukt, pauzeer je de afgespeelde media. Als het afspelen is gepauzeerd, kun je op de middelste knop van de D-pad drukken om het afspelen te hervatten. Met de linker- en rechterknop van de D-pad kun je het huidige nummer vooruit- en terugspoelen. Ga voor meer informatie naar Mediagebeurtenissen.

TV-PN

Items worden toegevoegd aan het kanaal Hierna bekijken op basis van de richtlijnen voor Hierna bekijken voor app-ontwikkelaars.

Sfeermodus TV-BU

Als er een door de gebruiker gestarte video wordt afgespeeld, voorkomt de app dat het apparaat overschakelt naar de Sfeermodus. Ga voor meer informatie naar Sfeermodus.

TV-BY

Als er geen door de gebruiker gestarte video of animatie wordt afgespeeld, voorkomt de app niet dat het apparaat overschakelt naar de Sfeermodus.

TV-BA

Bij het afspelen van alleen audio voorkomt de app niet dat het apparaat overschakelt naar de Sfeermodus, tenzij de app niet-statische afbeeldingen, zoals muziekvideo's of -afbeeldingen, toont terwijl er muziek wordt afgespeeld.

Google Play

Volg deze vereisten om je app consequent in te stellen in overeenstemming met andere vermeldingen en classificaties op Google Play:

Type Test Beschrijving
Beleid voor Play TV-G1

Het gebruik van Android App Bundles is verplicht voor alle nieuwe en bestaande tv-apps in de Google Play Store.

TV-G2

Je app moet voldoen aan de vereisten van het Beleidscentrum voor Play-ontwikkelaars.

Pagina App-details TV-G3

De app-functionaliteit werkt zoals verwacht of zoals beschreven in de Google Play Store-vermelding van de app.

TV-G4

De app-inzending heeft ten minste één ongewijzigd screenshot met hoge resolutie geüpload die de huidige versie van de functionaliteit van je tv-app nauwkeurig weergeeft.

Inloggegevens TV-G5

Voor apps met betaalde functies moet je inloggegevens invoeren in de Google Play Console om de volledige app-functionaliteit te testen. Ga voor meer informatie naar App-toegang in Je app voorbereiden voor beoordeling.

Veelgestelde vragen

Hoe weet ik nadat ik mijn app heb ingediend of mijn app niet voldoet aan alle vereisten voor tv's?

Als je app niet voldoet aan de vereisten voor gebruiksgemak die op deze pagina worden beschreven, neemt het Play Store-team contact met je op via het e-mailadres dat is verstrekt in het Google Play Console-account dat aan de app is gekoppeld.

Let op: Zorg dat je app de vereiste manifestvermeldingen voor tv's bevat. Anders wordt je app niet als tv-app beschouwd en wordt deze niet beoordeeld op geschiktheid voor tv-gebruik.

Mijn app target meer dan alleen tv's. Als mijn app niet voldoet aan de vereisten voor tv's, verschijnt mijn nieuwe of geüpdatete app dan nog steeds op Google Play voor andere apparaten?

Ja. De vereisten die op deze pagina worden beschreven, zijn alleen vereist voor distributie naar Google Play op tv's. Dit is niet van invloed op de distributie naar andere apparaattypen, zoals telefoons en tablets.

Als mijn app voldoet aan de publicatievereisten, wanneer is deze dan beschikbaar in de Google Play Store op tv's?

Apps die aan de tv-vereisten voldoen, verschijnen meteen in de Play Store op tv's.