Qualità dell'app TV

Gli utenti hanno aspettative diverse quando guardano la TV rispetto a quando utilizzano uno smartphone o un tablet. Un utente TV tipico si trova a circa 3 metri di distanza dallo schermo, quindi i piccoli dettagli sono meno evidenti e il testo piccolo è difficile da leggere. Poiché gli utenti si trovano lontano da una TV, devono utilizzare un telecomando per navigare ed effettuare selezioni invece di toccare gli elementi sullo schermo. Queste differenze incidono in modo significativo sui requisiti che determinano una buona esperienza utente sulla TV.

Il primo passo per creare un'esperienza ottimale per gli utenti TV consiste nel leggere e seguire le linee guida per la progettazione di Android TV. Per comprendere i requisiti fondamentali di implementazione per un'app per TV, consulta anche la formazione Creazione di app per la TV.

Importante: per garantire un'esperienza utente ottimale, le app per 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 le tue app per TV in Google Play, vedi Distribuzione su Android TV.

Design visivo e interazione utente

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

Tipo Test Descrizione
Avvio app TV-LM

Dopo l'installazione, l'app mostra un'icona Avvio app in Android TV Launcher. Per maggiori informazioni, consulta la sezione Dichiarare un'attività TV.

TV-LB

L'app mostra sia un banner a grandezza originale da 320 x 180 pixel sia un'icona dell'app di almeno 160 x 160 pixel (con densità xhdpi) come icone in Avvio applicazioni nell'Avvio app di Android TV. Per maggiori informazioni, consulta le linee guida per i banner e l'icona dell'app Android TV.

TV-BN

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

TV LG

Se l'app è un gioco, viene visualizzato nella riga Giochi di Android TV Launcher.
Per ulteriori informazioni, consulta Mostrare il tuo 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, consulta Eseguire app per la 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 può essere utilizzato solo il colore nero. Per maggiori informazioni, consulta Creare layout di base per la TV.

TV-OV

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

TV-TR

L'app non oscura parzialmente le altre app. L'app riempie l'intero schermo e ha uno sfondo non trasparente.

TV-DP

La funzionalità dell'app è navigabile utilizzando i controlli D-pad a cinque vie, 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, consulta la sezione Navigazione su TV.

TV-DK

Se l'app richiede un controller di gioco, come specificato nel criterio TV-GP, tutte le funzionalità possono essere utilizzate mediante le chiavi standard del controller di gioco Android. Per maggiori informazioni, consulta la pagina Pressione dei pulsanti del gamepad di elaborazione.

TV-DM

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

TV-DB

La pressione del pulsante Indietro porta alla schermata Home di Android TV. Per maggiori informazioni, consulta la sezione Specificare il comportamento appropriato del pulsante Indietro.

TV-DL

Se l'app dispone di un feed TV in diretta integrato nella scheda In diretta, l'app soddisfa i requisiti di riproduzione senza problemi e directback. 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 alla query in questione. Per maggiori informazioni, consulta Ricerca nelle app per TV.

Funzionalità

Questi criteri garantiscono che la tua app sia configurata correttamente e fornisca il comportamento funzionale previsto.

Tipo Test Descrizione
Manifest ML TV

Il file manifest dell'app imposta un tipo di intent ACTION_MAIN con categoria CATEGORY_LEANBACK_LAUNCHER. Per maggiori informazioni, consulta la sezione 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" su 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 inserimento principale, dichiara il requisito appropriato con il tag manifest <uses-feature>. Per maggiori informazioni, consulta la pagina Dichiarare il supporto dei controller di gioco.

TV-GC

Se l'app fornisce istruzioni visive per l'utilizzo dei controller di gioco, le istruzioni sono prive di branding e mostrano un layout dei pulsanti compatibile. Per maggiori informazioni, consulta la pagina 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, consulta la sezione 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 D-pad o del gamepad.

TV-AU

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

TV-AA

Per la pubblicità che utilizza annunci cliccabili, non a schermo intero e non video, l'app non consente il collegamento di annunci a un'altra app che non è disponibile sui dispositivi TV.

Contenuti web TV-WB

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

Riproduzione di contenuti multimediali TV-NP

Se l'app continua a riprodurre audio o video dopo che l'utente torna alla schermata Home o passa a un'altra app, fornisce una scheda Ora in riproduzione nella riga dei suggerimenti della schermata Home per consentire agli utenti di tornare all'app per controllare la riproduzione. Per maggiori informazioni, consulta Visualizzare una scheda Now Playing.

TV-PA

Se l'app fornisce una scheda Ora in riproduzione, 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, consulta KEYCODE_MEDIA_PLAY_PAUSE.

TV-PC

Durante la riproduzione di un video o audio, premi il pulsante centrale del D-pad per mettere in pausa i contenuti multimediali in riproduzione. Quando la riproduzione è in pausa, premi il pulsante centrale del D-pad per riprendere la riproduzione. I pulsanti D-pad sinistro e destro consentono di mandare avanti velocemente e riavvolgere la traccia corrente, rispettivamente. Per maggiori informazioni, consulta la sezione Eventi multimediali.

TV-PN

Gli elementi vengono aggiunti al canale Guarda in seguito in base alle linee guida relative a Guarda successivo per gli sviluppatori di app.

Modalità Ambient TV-BU

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

TV BY

Se non è presente alcuna animazione o riproduzione di video attiva avviata dall'utente, l'app non impedisce al dispositivo di attivare la modalità Ambient.

TV-BA

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

Google Play

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

Tipo Test Descrizione
Norme di Google Play TV G1

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

TV G2

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

Pagina dei dettagli dell'app TV G3

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

TV G4

L'app inviata ha caricato almeno uno screenshot ad alta risoluzione inalterato che mostra con precisione la versione corrente dell'esperienza dell'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, consulta Accesso alle app in Preparare l'app per la revisione.

Domande frequenti

Dopo aver inviato la mia app, come faccio a sapere se 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à tramite 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 per TV e non verrà esaminata per verificare i requisiti di usabilità della TV.

La mia app non si rivolge solo ai 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?

Sì. I requisiti descritti in questa pagina sono obbligatori solo per la distribuzione su Google Play sui dispositivi TV. La distribuzione su altri tipi di dispositivi, come telefoni e tablet, non è interessata.

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 vengono visualizzate immediatamente nel Play Store sui dispositivi TV.