Guía
Cómo usar Auto en Capacitor
Usando @capgo/capacitor-auto
@capgo/capacitor-auto conecta una aplicación Capacitor a superficies de CarPlay y Android Auto aprobadas. Su aplicación envía una lista de plantillas pequeña a la pantalla del coche, y la pantalla del coche envía acciones seleccionadas de regreso a JavaScript.
Está diseñado para flujos de trabajo seguros y controlados por políticas. No refleja tu WebView en el vehículo.
Instalar y sincronizar
npm install @capgo/capacitor-auto
npx cap sync
Enviar 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' },
},
],
},
],
});
Escuchar acciones del conductor
await Auto.addListener('carAction', async (event) => {
if (event.id === 'open-main-door') {
await openGarageDoor(event.payload?.doorId);
}
});
Ver 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
Requiere una licencia aprobada por Apple para tu categoría de aplicación. Agrega la configuración de la escena de CarPlay descrita en los documentos de configuración de iOS y mantén tu interfaz de vehículo dentro de plantillas aprobadas por Apple.
Requisitos de Android
El plugin incluye una implementación de la biblioteca de aplicaciones de automóvil de AndroidX. CarAppServicedeclaración de la template capacidad, y por defecto se ajusta a la IOT categoría. Revisa los documentos de configuración de Android si tu aplicación necesita otra categoría de Android Auto.
Consejos de diseño
Utiliza la superficie del coche para acciones cortas y predecibles:
- Estado de filas
- Comandos de una sola toca
- Confirmaciones seguras del conductor
- simple state handoff from the phone app
Keep complex flows in the phone UI and use carAction eventos como disparadores de intenciones nativas.
Mantenga adelante desde Usando @capgo/capacitor-auto
Si está utilizando Usando @capgo/capacitor-auto para planificar el comportamiento de medios y interfaz nativa, conecte con @capgo/capacitor-auto para el detalle de implementación en @capgo/capacitor-auto, Configuración inicial para los detalles de implementación en Configuración inicial Usando @capgo/capacitor-actividades-en-vivo para la capacidad nativa en Usando @capgo/capacitor-actividades-en-vivo @capgo/capacitor-actividades-en-vivo para los detalles de implementación en @capgo/capacitor-actividades-en-vivo, y Usando @capgo/capacitor-reproductor-de-videos para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos.