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 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 également être placé dans un autre filtre si vous le souhaitez.

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 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 adaptative à 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 significativement pillarboxées sur les écrans en mode paysage, comme indiqué dans la consigne de qualité des applications pour voitures DO-2.

Par exemple, si une application s'exécute au format portrait avec des bandes noires 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 un pillarbox minimal sur un écran en mode paysage est acceptable, tout comme une application s'exécutant au format paysage avec un letterbox sur un écran en mode portrait.

Tester avec des tailles d'écran standards

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 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 signalé par l'API CarConnection. Lorsque Android Auto est connecté, l'icône CONNECTION_TYPE_PROJECTION s'affiche.
  • 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, cette valeur est différente de DEFAULT_DISPLAY.

L'extrait de code 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)