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

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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 la section 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é dans le 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 dans un autre si vous préférez.

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

En plus de l'exigence précédente, les jeux présentent une exigence supplémentaire. Consultez Marquer votre application comme 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. Pour garantir une expérience de haute qualité dans les différentes voitures compatibles avec Android Auto, les applications ne doivent pas être affichées en mode pillarbox de manière significative sur les écrans en mode paysage, comme indiqué dans les consignes relatives à la qualité des applications pour voitures DO-2.

Par exemple, si une application s'exécute au format portrait avec un format pillarboxing sur un écran en mode paysage, elle sera refusée lors de l'examen sur le Play Store. Une application exécutée au format paysage avec un pillarboxing minimal sur un écran en mode paysage est acceptable, tout comme une application exécutée au format paysage avec un letterboxing sur un écran en mode portrait.

Tester sur les 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:

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

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é, il s'agit de 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, 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 connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY