Cómo agregar compatibilidad con Android Auto a tu app para usar en el vehículo estacionado

En dispositivos con Android 15 o versiones posteriores, Android Auto admite la ejecución de apps en categorías de apps estacionadas compatibles directamente en la consola central. Consulta Apps estacionadas para obtener más información sobre la experiencia del usuario de apps estacionadas en Android Auto.

Declara la compatibilidad con Android Auto

Para declarar que tu app es compatible con Android Auto, debes incluir el siguiente <category> elemento en el filtro de intents de una actividad en el manifiesto de tu app:

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

Por lo general, el elemento de categoría android.intent.category.CAR_LAUNCHER se puede colocar en el mismo filtro de intents que el elemento android.intent.category.LAUNCHER, pero puede estar en uno diferente si lo prefieres.

Entradas de manifiesto específicas de la categoría

Además del requisito anterior, los juegos tienen un requisito adicional. Consulta Cómo marcar tu app como un juego.

Compatibilidad con tamaños de pantalla comunes de Android Auto

Para obtener la mejor experiencia del usuario, te recomendamos que tu app sea completamente adaptable a diferentes tamaños de pantalla. Como mínimo, para garantizar una experiencia de alta calidad en la variedad de automóviles que admiten Android Auto, las apps no deben tener un formato de pilarboxing significativo en pantallas horizontales, como se captura en el DO-2 lineamiento de calidad de apps para automóviles.

Por ejemplo, si una app se ejecuta en una relación de aspecto vertical con pilarboxing en una pantalla horizontal, se rechazará durante la revisión de Play Store. Es aceptable una app que se ejecuta en una relación de aspecto horizontal con pilarboxing mínimo en una pantalla horizontal, al igual que una app que se ejecuta en una relación de aspecto horizontal con letterboxing en una pantalla vertical.

Prueba con tamaños de pantalla canónicos

Cuando compiles y pruebes tu app para Android Auto, puedes usar las siguientes configuraciones de la consola central de escritorio (DHU) para verificar que tu app cumpla con los requisitos anteriores:

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

Detecta el uso en Android Auto

Si deseas detectar cuándo se usa tu app a través de Android Auto (por ejemplo, para fines de análisis), puedes consultar dos indicadores:

• El estado de conexión que informa la CarConnection API. Cuando Android Auto está conectado, será CONNECTION_TYPE_PROJECTION.
• El ID de la pantalla activa. Cuando tu app se ejecuta en una pantalla que no es una pantalla integrada, como cuando se usa a través de Android Auto, este es un valor distinto de DEFAULT_DISPLAY.

En el siguiente fragmento, se muestra cómo combinar estos indicadores para detectar el uso a través de Android Auto:

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