Aggiungere il supporto di Android Auto all'app per il parcheggio

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Sui dispositivi con Android 15 o versioni successive, Android Auto supporta l'esecuzione di app nelle categorie di app supportate in modalità parcheggiata direttamente sull'unità principale. Consulta la sezione App in sosta per saperne di più sull'esperienza utente delle app in sosta su Android Auto.

Dichiarare il supporto di Android Auto

Per dichiarare che la tua app supporta Android Auto, devi includere il seguente elemento <category> nel filtro per intent di un'attività nel file manifest della tua app:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        ...
        <category android:name="android.intent.category.CAR_LAUNCHER" />
    </intent-filter>
</activity>

In genere, l'elemento della categoria android.intent.category.CAR_LAUNCHER può essere inserito nello stesso filtro intent dell'elemento android.intent.category.LAUNCHER, ma se preferisci può essere inserito in un altro.

Voci manifest specifiche per categoria

Oltre al requisito precedente, i giochi hanno un requisito aggiuntivo. Consulta l'articolo Contrassegnare l'app come gioco.

Supportare le dimensioni dello schermo comuni di Android Auto

Per un'esperienza utente ottimale, ti consigliamo di rendere l'app completamente adattabile a diverse dimensioni dello schermo. Come minimo, per garantire un'esperienza di alta qualità nella varietà di auto che supportano Android Auto, le app non devono avere un'inquadratura con riquadri laterali significativa sulle schermate orizzontali, come indicato dalle linee guida sulla qualità delle app per auto DO-2.

Ad esempio, se un'app viene eseguita con un formato orizzontale con pillarboxing su un schermo orizzontale, verrà rifiutata durante la revisione del Play Store. È accettabile un'app in esecuzione con proporzioni orizzontali e con un'area nera minima su uno schermo orizzontale, così come un'app in esecuzione con proporzioni orizzontali e con un'area nera su uno schermo verticale.

Eseguire test in base alle dimensioni dello schermo canoniche

Quando crei e testi la tua app per Android Auto, puoi utilizzare le seguenti configurazioni di unità principali da computer (DHU) per verificare che l'app soddisfi i requisiti precedenti:

[general]
resolution = 800x480
dpi = 160
...

[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...

[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...

Rilevare l'utilizzo su Android Auto

Se vuoi rilevare quando la tua app viene utilizzata tramite Android Auto (ad esempio per finalità di analisi), puoi esaminare due indicatori:

• Lo stato della connessione segnalato dall'API CarConnection. Quando Android Auto è connesso, sarà CONNECTION_TYPE_PROJECTION.
• L'ID della visualizzazione attiva. Quando l'app viene eseguita su un display diverso da uno schermo integrato, ad esempio quando viene utilizzata tramite Android Auto, questo è un valore diverso da DEFAULT_DISPLAY.

Lo snippet seguente mostra come combinare questi indicatori per rilevare l'utilizzo tramite Android Auto:

val connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY