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.
Per informazioni su come pubblicare app TV in Google Play, vedi Distribuire su Android TV.
Elenchi di controllo per la compatibilità delle app TV
Gli elenchi di controllo della compatibilità definiscono i criteri per aiutarti a valutare il livello di supporto fornito dalla tua app per Android TV OS.
I livelli di assistenza includono:
Livello 3 - TV Ready
La tua app soddisfa i requisiti fondamentali per essere eseguita sui dispositivi con sistema operativo Android TV.
Livello 2 - Ottimizzato per la TV
La tua app offre un'esperienza più personalizzata e fluida per i dispositivi Android TV OS.
Livello 1 - TV differenziata
La tua app offre un'esperienza premium che sfrutta appieno le funzionalità avanzate del sistema operativo Android TV.
Livello 3 - TV Ready
| 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, vedi 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 ulteriori informazioni, vedi 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 | L'app supporta l'orientamento orizzontale senza letterbox o pillarbox verticali. Utilizza solo il colore nero per le barre nei video in formato originale. 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. | |
| Navigazione | 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, vedi Pulsante Indietro. | |
| SDK | TV-PS | Oltre ai requisiti di base per prestazioni e stabilità, l'app dichiara il supporto per i dispositivi Android TV di uso comune impostando una versione minima dell'SDK Android pari a 31 o inferiore impostando il valore minSdkVersion. |
| Manifest | TV-ML | Il file manifest dell'app imposta un tipo di intent di ACTION_MAIN con categoria CATEGORY_LEANBACK_LAUNCHER. Per maggiori informazioni, vedi 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 saperne di più, consulta 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. |
| TV-AD | Per la pubblicità che mostra 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 la pubblicità che utilizza annunci non video cliccabili, non a schermo intero, l'app non consente agli annunci di rimandare a un'altra app non disponibile sui dispositivi TV. | |
| Contenuti web | TV-WB | Per i contenuti web, l'app deve utilizzare solo i componenti WebView. L'app non deve tentare di avviare un'app browser web. |
| Riproduzione di contenuti multimediali | TV-NP | 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 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. Le app video non devono utilizzare la scheda Now Playing e la riproduzione del video deve essere messa in pausa quando l'utente esce dall'app. |
| 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-PN | Gli elementi aggiunti a Cosa guardare rispettano le linee guida di Cosa guardare per gli sviluppatori di app. | |
| Riproduzione di contenuti multimediali | 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 saperne di più, vedi Eventi multimediali. |
| 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 saperne di più, consulta KEYCODE_MEDIA_PLAY_PAUSE. |
|
| 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 ulteriori 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. | |
| PIP | TV-IC | Se l'app utilizza la modalità Picture in picture, imposta i metadati appropriati per classificare il suo utilizzo della modalità Picture in picture in uno dei tipi di utilizzo consentiti. Inoltre, dichiara un titolo e un sottotitolo che rappresentano accuratamente lo scopo di questo PIP. Per maggiori informazioni, vedi Multitasking sulla TV. |
| TV-IP | In modalità Picture in picture, l'app non mostra materiale promozionale o pubblicità che non fanno parte intrinsecamente della fonte dei contenuti. | |
| TV-IQ | 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, acquisire il focus audio, interferire con MediaSession attiva o richiedere un numero sproporzionato di sessioni di decodifica. | |
| TV-IH | In modalità Picture in picture, l'app non mostra controlli dell'interfaccia utente o elementi navigabili. Le app possono esporre determinati controlli utente direttamente nella finestra PIP. | |
| TV-IE | L'attivazione della modalità Picture in picture richiede un'azione esplicita e intenzionale da parte 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 impegnato in una chiamata in corso. |
|
| TV-IS | L'app non deve mostrare alcuna UI per attivare la modalità PIP se questa è disattivata su un dispositivo. | |
| TV-IX | L'app utilizza la modalità Picture in picture solo per la continuazione di un'attività continua. L'esperienza Picture in picture non incentiva né incoraggia gli utenti a tornare alla visualizzazione a schermo intero dell'app durante l'attività in corso o dopo il suo completamento. | |
| Memoria | TV-ME | Per i dispositivi con poca RAM (dove ActivityManager.isLowRamDevice() restituisce true), la memoria utilizzata massima (Anon+Swap + Graphics + File Memory) di un'app in primo piano deve rimanere entro i limiti (inclusi meccanismi di misurazione e avvertenze specifici) definiti in Ottimizzare l'utilizzo della memoria. |
| Google Play | TV-G1 | L'utilizzo degli Android App Bundle è obbligatorio per tutte le app TV nuove ed esistenti nel Google Play Store. |
| TV-G2 | L'app deve rispettare i requisiti del Centro norme per gli sviluppatori di Play. | |
| TV-G6 | A partire dal 1° agosto 2026, le app TV devono supportare le architetture a 64 bit. | |
| TV-G7 | A partire dal 1° agosto 2026, le app TV devono supportare dimensioni delle pagine di 16 kB. | |
| 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 che richiedono l'accesso degli utenti, 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. |
Livello 2 - Ottimizzato per la TV
| Tipo | Test | Descrizione |
|---|---|---|
| UI | TV-4K | L'app include asset dell'interfaccia utente 4K, inclusa l'icona dell'applicazione. |
| Connettività | TV-CT | Se l'app ha una controparte mobile che supporta Cast, l'app TV si integra con TV Cast Receiver (Cast Connect) per consentire agli utenti di trasmettere contenuti dal proprio smartphone o tablet alla TV. |
| Accedi | TV-LI | Interfaccia di accesso: gli utenti possono accedere utilizzando il dispositivo mobile o l'Account Google per un accesso senza problemi. |
| TV-LC | L'app archivia in modo sicuro le credenziali utente o accede automaticamente agli utenti di ritorno tramite l'autenticazione basata su token o metodi di archiviazione sicuri. In questo modo, si riduce notevolmente l'attrito per gli utilizzi successivi dopo la configurazione iniziale. | |
| Voce | TV-VS | L'app integra funzionalità di ricerca vocale per il rilevamento di contenuti in linguaggio naturale. |
| TV-VC | L'app integra i comandi vocali per la riproduzione e la navigazione. | |
| Rendimento | TV-BP | L'app include profili di base per migliorare le prestazioni complessive, ad esempio l'avvio dell'app e la riduzione dei problemi di scorrimento. |
Livello 1 - TV differenziata
| Tipo | Test | Descrizione |
|---|---|---|
| Coinvolgimento | TV-EC | L'app invia i tipi di entità dei contenuti che gli utenti possono riprendere a guardare, ad esempio un film interrotto o l'episodio successivo di una serie, tramite l'SDK Engage. |
| TV-ER | L'app invia i tipi di entità di contenuti pertinenti per consentire la visualizzazione dei consigli tramite l'SDK Engage. | |
| Funzionalità del dispositivo | TV-PI | L'app seleziona un profilo immagine preimpostato della TV per i contenuti pertinenti (profilo cinema per i film, bassa latenza / contrasto elevato per eventi sportivi o partite in diretta) |
| TV-AO | L'app reagisce senza problemi al cambio di output audio selezionando il miglior canale audio per i dispositivi di output supportati (ad es. un canale stereo per le cuffie o 5.1 per gli speaker surround) | |
| TV-FR | L'app supporta la richiesta del frame rate dei contenuti, in modo che il display possa passare alla modalità di riproduzione corretta ed evitare il jitter (ad es. 50 Hz per contenuti a 50 fps) | |
| TV-TO | L'app supporta il tocco e il clic per consentire la compatibilità con i telecomandi con puntatore e i display touchscreen. I componenti UI mostrano uno stato di passaggio del mouse quando il cursore si trova sopra un componente con cui è possibile interagire. I componenti possono essere selezionati e i contenitori scorrevoli possono scorrere verticalmente e orizzontalmente. | |
| TV-SA | L'app supporta l'audio spaziale per un'esperienza di ascolto immersiva. Ad esempio, l'app potrebbe utilizzare il codec IAMF. | |
| Controller di gioco | TV-GF | Il gioco supporta completamente una serie di controller di gioco. |
| Accessibilità | TV-AX | L'app implementa opzioni di accessibilità avanzate, come descrizioni audio, visualizzazione dei sottotitoli (inclusi stili preferiti e modalità ad alto contrasto), modalità UI ad alto contrasto generale, modalità di navigazione semplificate e velocità di riproduzione regolabile. Dimostra un profondo impegno per l'inclusività, garantendo un'esperienza premium accessibile e piacevole per tutti. |
| AI | TV-AI | L'app implementa esperienze con AppFunctions o AI in-app. |
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à utilizzando l'indirizzo email specificato nell'account Google Play Console associato all'app.
La mia app ha come target fattori di forma diversi dai soli dispositivi TV. Se la mia app non soddisfa i requisiti per i dispositivi TV, l'app nuova o aggiornata viene comunque visualizzata su Google Play per altri dispositivi?
Gli aggiornamenti alla scheda del Google Play Store possono essere pubblicati solo se tutte le modifiche vengono approvate. Se l'aggiornamento di un artefatto specifico per un fattore di forma blocca ulteriori aggiornamenti della tua scheda per altri dispositivi come smartphone o tablet, ti consigliamo di rimuovere l'artefatto sostituendolo con un invio vuoto finché non potrai soddisfare 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.
Note relative alle modifiche
Maggio 2026
- Livelli di qualità delle app TV
- Sono stati aggiunti i criteri di qualità ottimizzata per la TV (livello 2) e differenziata per la TV (livello 1) per chiarire le esperienze TV premium oltre i requisiti minimi di invio (livello 3).
Cerca
Gennaio 2026
Norme di Play
Nuovo criterio,
TV-G6:A partire dal 1° agosto 2026, la tua app deve supportare le architetture a 64 bit.
Nuovo criterio,
TV-G7:A partire dal 1° agosto 2026, la tua app deve supportare dimensioni di pagina di 16 kB.
Dicembre 2025
Prestazioni previste
Nuovo criterio,
TV-PS:Oltre ai requisiti di stabilità e prestazioni di base, la tua app deve supportare i dispositivi Android TV più utilizzati impostando una versione minima dell'SDK Android pari a 31 o inferiore.
Novembre 2024
Funzionalità e prestazioni
Nuovo criterio,
TV-ME:Per i dispositivi con poca RAM (dove
ActivityManager.isLowRamDevice()restituiscetrue), l'utilizzo massimo della memoria utilizzata (Anon+Swap + Graphics + File Memory) di un'app in primo piano deve rimanere entro i limiti (inclusi meccanismi di misurazione e avvertenze specifici) definiti in Ottimizzare l'utilizzo della memoria.
Maggio 2024
Riproduzione di contenuti multimediali
Criterio aggiornato,
TV-NP:Il criterio è stato aggiornato per essere applicato solo alla riproduzione audio, non video. Ora consigliamo anche di mettere in pausa il video quando l'app è in background.