Saltar al contenido principal
Volver a plugins
@capgo/capacitor-auto
Tutorial
@capgo/capacitor-auto

Automático

Ponte los aplicaciones Capacitor con las superficies de CarPlay y Android Auto para la comunicación de dos vías en el automóvil

Guía

Tutoriales de Auto

Probar en dispositivo

Descargar la aplicación Capgo, luego escanea el código QR code.

Enlace QR de vista previa del plugin Auto code

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.

No es una herramienta para flujos de trabajo de control de políticas y seguro para el conductor. No refleja su WebView en el coche.

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);
  }
});

Observar el estado de la 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 una autorización de Apple aprobada para su categoría de aplicación. Agregue la configuración de escena de CarPlay descrita en el Documentación de configuración de iOS y mantén la interfaz de tu vehículo dentro de plantillas aprobadas por Apple.

Requisitos de Android

Android Auto utiliza la biblioteca de aplicaciones de vehículos de AndroidX. El plugin incluye un CarAppServicedeclaración de la template capacidad, y se ajusta por defecto a la IOT categoría. Revisa la documentación de configuración de Android si tu aplicación necesita otra categoría de Android Auto.

Guía de diseño

Utiliza la superficie del vehículo para acciones cortas y predecibles:

  • filas de estado
  • comandos de una sola toca
  • confirmaciones seguras del conductor
  • cambio de estado simple desde la aplicación del teléfono

Mantén flujos complejos en la interfaz del teléfono y utiliza carAction los eventos como disparadores de intención nativa.

Sigue adelante desde el uso de @capgo/capacitor-auto

Si estás utilizando Usando @capgo/capacitor-auto para planificar el comportamiento de medios y interfaz nativa, conecta con @capgo/capacitor-auto para el detalle de implementación en @capgo/capacitor-auto, Iniciación para los detalles de implementación en Getting Started 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.