Guía
Cómo usar Auto en Capacitor
Uso de @capgo/capacitor-auto
@capgo/capacitor-auto conecta una app de Capacitor a interfaces de CarPlay y Android Auto aprobadas. Tu app envía una lista pequeña de plantillas a la pantalla del coche, y la pantalla devuelve las acciones seleccionadas a JavaScript.
Está diseñado para flujos de trabajo seguros para el conductor y controlados por políticas. No proyecta tu WebView en el coche.
Instalar y sincronizar
npm install @capgo/capacitor-auto
npx cap sync
Envía una plantilla al coche
import { Auto } from '@capgo/capacitor-auto';
await Auto.setRootTemplate({
title: 'Garage',
sections: [
{
header: 'Doors',
items: [
{
id: 'open-main-door',
title: 'Open main door',
subtitle: 'Tap to send the action to the phone app',
payload: { doorId: 'main' },
},
],
},
],
});
Escucha las acciones del conductor
await Auto.addListener('carAction', async (event) => {
if (event.id === 'open-main-door') {
await openGarageDoor(event.payload?.doorId);
}
});
Monitorea el estado de conexión
const status = await Auto.isAvailable();
console.log(status.available, status.connected, status.platform);
await Auto.addListener('connectionChanged', (event) => {
console.log('Car connected:', event.connected, event.platform);
});
Requisitos de iOS
CarPlay requiere un entitlement aprobado por Apple para tu categoría de app. Añade la configuración de escena CarPlay descrita en la documentación de configuración de iOS y mantén tu UI del coche dentro de las plantillas aprobadas por Apple.
Requisitos de Android
Android Auto usa AndroidX Car App Library. El plugin incluye un CarAppService, declara la template capacidad y usa por defecto la IOT categoría. Revisa la Docs de configuración de Android si tu app requiere otra categoría de Android Auto.
Guía de diseño
Usa la interfaz del coche para acciones cortas y predecibles:
- filas de estado
- comandos de un toque
- confirmaciones seguras para el conductor
- handoff de estado simple desde la app móvil
Mantén los flujos complejos en la UI del móvil y usa carAction eventos como triggers de intents nativos.
Continúa desde Uso de @capgo/capacitor-auto
Si estás usando Uso de @capgo/capacitor-auto para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con @capgo/capacitor-auto por los detalles de implementación en @capgo/capacitor-auto, Primeros pasos para los detalles de implementación en Primeros pasos, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para el detalle de implementación en @capgo/capacitor-live-activities, y Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player.