Ajouter la prise en charge d'Android Auto à votre application à utiliser à l'arrêt

Sur les appareils équipés d'Android 15 ou version ultérieure, Android Auto permet d'exécuter des applications dans les catégories d'applications compatibles en mode stationnement directement sur l'unité principale. Pour en savoir plus sur l'expérience utilisateur des applications en mode stationnement sur Android Auto, consultez Applications en mode stationnement.

Déclarer la prise en charge d'Android Auto

Pour déclarer que votre application est compatible avec Android Auto, vous devez inclure l'élément <category> suivant dans le filtre d'intent d'une activité du fichier manifeste de votre application :

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

En règle générale, l'élément de catégorie android.intent.category.CAR_LAUNCHER peut être placé dans le même filtre d'intent que l'élément android.intent.category.LAUNCHER, mais il peut se trouver dans un autre si vous le préférez.

Entrées de fichier manifeste spécifiques à une catégorie

En plus de l'exigence précédente, les jeux doivent respecter une exigence supplémentaire. Consultez Marquer votre application comme un jeu.

Prendre en charge les tailles d'écran Android Auto courantes

Pour une expérience utilisateur optimale, nous vous recommandons de rendre votre application entièrement adaptable aux différentes tailles d'écran. Au minimum, pour garantir une expérience de haute qualité dans les différentes voitures compatibles avec Android Auto, les applications ne doivent pas être mises au format pillarbox de manière significative sur les écrans en mode paysage, comme indiqué dans la DO-2 consigne relative à la qualité des applications pour voitures.

Par exemple, si une application s'exécute au format portrait avec une mise au format letterbox sur un écran en mode paysage, elle sera refusée lors de l'examen du Play Store. Une application s'exécutant au format paysage avec une mise au format letterbox minimale sur un écran en mode paysage est acceptable, tout comme une application s'exécutant au format paysage avec une mise au format letterbox sur un écran en mode portrait.

Tester sur des tailles d'écran canoniques

Lorsque vous créez et testez votre application pour Android Auto, vous pouvez utiliser les configurations d'unité principale pour ordinateur (DHU) suivantes pour vérifier qu'elle répond aux exigences précédentes :

Petit format paysage

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

Grand format paysage

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

Portrait

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

Détecter l'utilisation sur Android Auto

Si vous souhaitez détecter quand votre application est utilisée via Android Auto (par exemple, à des fins d'analyse), vous pouvez examiner deux signaux :

  • L'état de la connexion signalé par l'API CarConnection. Lorsque Android Auto est connecté, il s'agit de CONNECTION_TYPE_PROJECTION.
  • L'ID d'affichage de l'écran actif. Lorsque votre application s'exécute sur un écran autre qu'un écran intégré, par exemple lorsqu'elle est utilisée via Android Auto, il s'agit d'une valeur autre que DEFAULT_DISPLAY.

L'extrait suivant montre comment combiner ces signaux pour détecter l'utilisation via Android Auto :

val displayId = context.display?.displayId ?: DEFAULT_DISPLAY
isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)