Saltar al contenido principal
@capgo/capacitor-auto Dispositivos de API Fuente abierta

Auto plugin de Capacitor

Conecta aplicaciones Capacitor con superficies de CarPlay y Android Auto para comunicación de dos vías en el vehículo

Instalar

bun add @capgo/capacitor-auto bunx cap sync
pnpm o yarn de npm
  • npm install @capgo/capacitor-auto
  • pnpm add @capgo/capacitor-auto
  • yarn add @capgo/capacitor-auto

Guía

Cómo usar Auto en Capacitor

Probar en dispositivo

Descargue la aplicación Capgo y escane el código QR code.

Vista previa del plugin Auto QR 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.

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.

FAQ

Preguntas frecuentes del plugin Auto

¿Cómo instalo el plugin Auto en una aplicación Capacitor?

Run "bun add @capgo/capacitor-auto" (or "npm install @capgo/capacitor-auto"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-auto" in your app code.

¿Funciona @capgo/capacitor-auto con React, Vue y Angular?

Yes. Auto es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Cuál versión de Capacitor soporta @capgo/capacitor-auto?

Los plugins de Capgo siguen la versión mayor de Capacitor: utilice la versión mayor del plugin que coincida con la versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-auto gratuito y de código abierto?

¡Sí! El código fuente de code está público en GitHub en https://github.com/Cap-go/capacitor-auto/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

¿Puedo actualizar code que utiliza Auto sin una revisión de la Tienda?

Instalar o actualizar el plugin cambia el code nativo, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al plugin pueden enviar instantáneamente con Capgo actualizaciones en vivo.

Envía cambios de Auto sin esperar a la revisión de la aplicación

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían los cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Inicie con Capgo