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 à utiliser à l'arrêt compatibles directement sur l'unité principale. Pour en savoir plus sur l'expérience utilisateur des applications à utiliser à l'arrêt sur Android Auto, consultez Applications à utiliser à l'arrêt.

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 général, 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 être placé 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 sont soumis à une exigence supplémentaire. Consultez Marquer votre application comme application de jeu.

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

Pour offrir une expérience utilisateur optimale, nous vous recommandons de rendre votre application entièrement adaptative 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 fortement au format pillarbox sur les écrans en mode paysage, comme indiqué dans la consigne DO-2 relative à la qualité des applications pour voitures.

Par exemple, si une application s'exécute dans un format portrait avec des bandes noires verticales sur un écran au format paysage, elle sera refusée lors de l'examen sur le Play Store. Une application s'exécutant au format paysage avec un minimum de bandes noires verticales sur un écran paysage est acceptable, tout comme une application s'exécutant au format paysage avec des bandes noires horizontales sur un écran portrait.

Tester sur des tailles d'écran standards

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

Petit paysage

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

Paysage large

[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 :

  • État de la connexion indiqué par l'API CarConnection. Lorsque Android Auto est connecté, cette icône est CONNECTION_TYPE_PROJECTION.
  • ID 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 connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY