Qualità dell'app TV

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.

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.

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

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.

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.

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.

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

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

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.

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.

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

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

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.

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.

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.

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.

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.

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.

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

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.

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.

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.

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

Se l'app continua a riprodurre l'audio dopo che l'utente torna alla schermata Home o passa a un'altra app, l'app fornisce una scheda In riproduzione 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.

Ti consigliamo di mettere in pausa il video quando l'utente esce dall'app e di non integrare il video con la scheda In riproduzione.

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.

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.

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.

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

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.

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

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.

Per i dispositivi con poca RAM (in cui ActivityManager.isLowRamDevice() restituisce true), l'utilizzo massimo della memoria ( Anon+Swap + Grafica + Memoria file) di un'app in primo piano deve rimanere all'interno dei limiti (inclusi meccanismi di misurazione specifici e avvertenze) definiti in Ottimizzare l'utilizzo della memoria.

L'app imposta i metadati appropriati per classificare l'utilizzo della modalità Picture in picture in uno dei tipi di utilizzo consentiti. Dichiara inoltre un titolo e un sottotitolo che rappresentano con precisione lo scopo di questo PIP.

Per maggiori informazioni, consulta Multitasking sulla TV.

In modalità Picture in picture, l'app non mostra materiale promozionale o pubblicità che non fa parte intrinsecamente della sorgente dei contenuti.

In modalità Picture in picture, l'app non peggiora l'esperienza di un'altra attività a schermo intero.

L'app non deve utilizzare risorse eccessive, assumere il controllo dell'audio, interferire con MediaSession attivo o richiedere un numero sproporzionato di sessioni di decodifica.

L'app non mostra controlli dell'interfaccia utente o elementi navigabili in modalità Picture in picture. Le app potrebbero esporre determinati controlli utente direttamente nella finestra PiP.

L'attivazione della modalità Picture in picture richiede un'azione esplicita e intenzionale dell'utente all'interno dell'app. L'app non attiva automaticamente la modalità PiP (setAutoEnterEnabled impostato su false) a meno che l'utente non sia in una chiamata in corso.

L'app non deve mostrare alcuna interfaccia utente per accedere alla modalità PiP se questa è disattivata su un dispositivo.

L'app utilizza la modalità Picture in picture solo per la continuazione di un'attività in corso. L'esperienza PiP non incentiva o incoraggia gli utenti a tornare alla visualizzazione a schermo intero dell'app durante l'attività o al termine dell'attività.

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

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

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

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.

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.