Qualità dell'app TV

Gli utenti hanno aspettative diverse quando guardano la TV rispetto a quando utilizzano uno smartphone o un tablet. Generalmente, un utente della TV si trova a circa 3 metri di distanza dallo schermo, quindi i piccoli dettagli sono meno visibili e il testo piccolo è difficile da leggere. Dato che gli utenti sono lontani dalla TV, devono usare un telecomando per navigare ed effettuare selezioni, anziché toccare gli elementi sullo schermo. Queste differenze influiscono notevolmente sui requisiti che determinano una buona esperienza utente sulla TV.

Il primo passo per creare un'esperienza ottimale per gli utenti della TV è esaminare e seguire le linee guida per la progettazione di Android TV. Per comprendere i requisiti di implementazione fondamentali per un'app TV, consulta anche la pagina Creare app TV.

Importante: per garantire un'esperienza utente ottimale, le app per i dispositivi TV devono soddisfare requisiti specifici di usabilità. Solo le app che soddisfano i criteri di qualità in questa pagina sono considerate app per Android TV su Google Play.

Per informazioni su come pubblicare app TV in Google Play, vedi Distribuire su Android TV.

Progettazione visiva e interazione degli utenti

I seguenti criteri contribuiscono a garantire che la tua app rispetti pattern di progettazione e interazione fondamentali per un'esperienza utente coerente, intuitiva e piacevole sui dispositivi TV.

Tipo Test Descrizione
Avvio app TV-LM

L'app mostra un'icona in Avvio applicazioni in Avvio app di Android TV dopo l'installazione. Per maggiori informazioni, visita la pagina Dichiarare un'attività TV.

TV-LB

L'app mostra sia un banner di dimensioni intere da 320 x 180 pixel sia un'icona dell'app di almeno 160 x 160 pixel (con densità xhdpi) come icone in Avvio applicazioni in Avvio app di Android TV. Per maggiori informazioni, consulta le linee guida relative ai banner e all'icona dell'app per Android TV.

TV-BN

Il banner di avvio dell'app contiene il nome dell'app.

TV-LG

Se l'app è un gioco, viene visualizzata nella riga Giochi di Avvio app di Android TV.
Per maggiori informazioni, consulta Mostrare il gioco nella schermata Home.

TV-LS

L'app viene eseguita correttamente e senza messaggi di errore, anche durante l'installazione, il caricamento e i test. Per maggiori informazioni, vedi Eseguire app TV.

Layout TV-LO

Tutte le interfacce dell'app sono presentate con orientamento orizzontale e senza letterbox/pillarbox verticali. Per le barre nei video in formato originale è possibile utilizzare solo il colore nero. Per maggiori informazioni, consulta la pagina Creare layout di base per la TV.

TV-OV

L'app non mostra testo o funzionalità parzialmente tagliati dai bordi dello schermo. Per maggiori informazioni, vedi Overscan.

TV-TR

L'app non oscura parzialmente altre app. L'app riempie tutto lo schermo e ha uno sfondo non trasparente.

TV-DP

La funzionalità dell'app è navigabile utilizzando i controlli D-pad a cinque direzioni, a meno che l'app non richieda un controller di gioco, come specificato nel criterio TV-GP nella sezione Controller della tabella Funzionalità che segue. Per maggiori informazioni, vedi Navigazione TV.

TV-DK

Se l'app richiede un controller di gioco, come specificato nel criterio TV-GP, tutte le funzionalità sono navigabili utilizzando i tasti del controller di gioco Android standard. Per maggiori informazioni, consulta la pagina Elaborare pressioni dei pulsanti del gamepad.

TV-DM

L'app non dipende da un telecomandato che dispone di un pulsante Menu per accedere ai controlli dell'interfaccia utente.

TV-DB

La pressione del pulsante Indietro rimanda alla schermata Home di Android TV. Per maggiori informazioni, vedi Fornire il comportamento appropriato del pulsante Indietro.

TV-DL

Se l'app dispone di un feed TV in diretta integrato nella scheda In diretta, soddisfa i requisiti di riproduzione e direct-back senza problemi. Per maggiori informazioni, consulta la sezione Pulsante Indietro.

TV-SB

Una query di ricerca in-app viene visualizzata nella casella di ricerca, in modo simile all'interfaccia utente fornita da SearchFragment e i risultati sono pertinenti per la query. Per maggiori informazioni, visita la pagina Eseguire ricerche nelle app TV.

Funzionalità

Questi criteri assicurano che l'app sia configurata correttamente e che fornisca il comportamento funzionale previsto.

Tipo Test Descrizione
Manifest TV-ML

Il file manifest dell'app imposta un tipo di intent di ACTION_MAIN con categoria CATEGORY_LEANBACK_LAUNCHER. Per maggiori informazioni, visita la pagina Dichiarare un'attività TV.

TV-MT

Il file manifest dell'app imposta la funzionalità hardware android.hardware.touchscreen e altre elencate nella sezione "Dichiarare i requisiti hardware per la TV" come non obbligatorie. Per maggiori informazioni, consulta la pagina Dichiarare i requisiti hardware per la TV.

Controller di gioco TV-GP

Se l'app utilizza un controller di gioco come metodo di immissione principale, dichiara il requisito appropriato con il tag manifest <uses-feature>. Per maggiori informazioni, visita la pagina Dichiarare il supporto dei controller di gioco.

TV-GC

Se l'app fornisce istruzioni visive per l'uso dei controller di gioco, le istruzioni sono prive di branding e mostrano un layout dei pulsanti compatibile. Per maggiori informazioni, vedi Gestire i controller per i giochi.

pubblicità TV-AP

L'app consente di interagire con la pubblicità utilizzando i controlli del D-pad. Per maggiori informazioni, vedi Abilitare la navigazione con D-pad.

ANNUNCIO TV

Per la pubblicità che utilizza annunci non video a schermo intero, l'app consente all'utente di chiudere immediatamente l'annuncio con i controlli del D-pad o del gamepad.

TV-AU

Per la pubblicità che utilizza annunci non video cliccabili, non a schermo intero, l'app non consente agli annunci di rimandare a un URL web.

TV-AA

Per gli annunci che utilizzano annunci non video cliccabili, non a schermo intero, l'app non consente agli annunci di reindirizzare a un'altra app non disponibile sui dispositivi TV.

Contenuti web TV-WB

Per i contenuti web, l'app può utilizzare solo i componenti WebView. L'app potrebbe non tentare di avviare un'app browser web.

Riproduzione di contenuti multimediali TV-NP

Se l'app continua a riprodurre l'audio o il video dopo che l'utente torna alla schermata Home o passa a un'altra app, l'app fornisce una scheda Now Playing nella riga dei consigli della schermata Home, così gli utenti possono tornare all'app per controllare la riproduzione. Per maggiori informazioni, vedi Visualizzare una scheda Now Playing.

TV-PA

Se l'app fornisce una scheda Now Playing, la selezione di questa scheda porta l'utente a una schermata che consente di mettere in pausa la riproduzione.

TV-PP

Se l'app riproduce contenuti video o musicali, l'app alterna la riproduzione e la messa in pausa della riproduzione di contenuti multimediali quando viene inviato un evento chiave di riproduzione o pausa durante la riproduzione. Per maggiori informazioni, vedi KEYCODE_MEDIA_PLAY_PAUSE.

TV-PC

Durante la riproduzione di un video o audio, la pressione del pulsante centrale del D-pad mette in pausa la riproduzione dei contenuti multimediali. Quando la riproduzione è in pausa, se viene premuto il pulsante centrale del D-pad la riproduzione riprende. I pulsanti sinistro e destro del D-pad mandano avanti velocemente e riavvolgono la traccia corrente. Per maggiori informazioni, vedi Eventi multimediali.

TV-PN

Gli elementi vengono aggiunti al canale Cosa guardare in base alle linee guida di Cosa guardare per gli sviluppatori di app.

Modalità Ambient TV-BU

Quando viene avviata dall'utente la riproduzione di video attiva, l'app impedisce al dispositivo di impostare la modalità Ambient. Per maggiori informazioni, vedi Modalità Ambient.

TV-BY

In assenza di animazioni o riproduzioni di video attive avviate dall'utente, l'app non impedisce al dispositivo di passare alla modalità Ambient.

TV-BA

Per la riproduzione in modalità solo audio, l'app non impedisce al dispositivo di attivare la modalità Ambient, a meno che non implementi un'esperienza di immagini non statiche, come immagini o video musicali, durante la riproduzione della musica.

Google Play

Segui questi requisiti per configurare la tua app in modo coerente con altre schede e classificazioni su Google Play:

Tipo Test Descrizione
Norme di Play TV G1

L'utilizzo degli Android App Bundle è obbligatorio per tutte le app TV nuove ed esistenti nel Google Play Store.

TV G2

La tua app deve rispettare i requisiti del Centro norme per gli sviluppatori.

Pagina dei dettagli dell'app TV G3

La funzionalità dell'app funziona come previsto o come descritto nella scheda del Google Play Store dell'app.

TV G4

L'invio dell'app ha caricato almeno uno screenshot ad alta risoluzione non modificato che mostra con precisione la versione corrente dell'esperienza con l'app TV.

Credenziali di accesso TV G5

Per le app con funzionalità a pagamento, devi fornire le credenziali di accesso in Google Play Console per testare l'esperienza completa dell'app. Per maggiori informazioni, vedi Accesso alle app nella pagina Preparare l'app per la revisione.

Domande frequenti

Dopo aver inviato la mia app, come faccio a sapere se la mia app non soddisfa tutti i requisiti per i dispositivi TV?

Se la tua app non soddisfa i requisiti di usabilità descritti in questa pagina, il team del Play Store ti contatterà utilizzando l'indirizzo email specificato nell'account Google Play Console associato all'app.

Attenzione: assicurati che l'app includa le voci manifest richieste per i dispositivi TV. In caso contrario, la tua app non verrà considerata un'app TV e non verrà esaminata per verificare i requisiti di usabilità per la TV.

La mia app è indirizzata a fattori di forma diversi dai soli dispositivi TV. Se la mia app non soddisfa i requisiti dei dispositivi TV, la mia app nuova o aggiornata continuerà a essere visualizzata su Google Play per altri dispositivi?

Gli aggiornamenti alla tua scheda del Google Play Store possono essere pubblicati soltanto se tutte le modifiche vengono approvate. Se un aggiornamento di un elemento specifico per fattore di forma blocca ulteriori aggiornamenti alla tua scheda per altri dispositivi come telefoni o tablet, ti consigliamo di rimuovere quell'elemento sostituendolo con un invio vuoto finché non soddisfi i requisiti.

Se la mia app soddisfa i requisiti di pubblicazione, quando sarà disponibile nel Google Play Store sui dispositivi TV?

Le app che soddisfano i requisiti per la TV verranno visualizzate immediatamente nel Play Store sui dispositivi TV.