Saltar al contenido principal
@capgo/capacitor-auto API de dispositivos Código abierto

Automático plugin Capacitor

Conecta tus apps Capacitor con plantillas de CarPlay y Android Auto para comunicación bidireccional en el coche

Instalar

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

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.

FAQ

FAQ del plugin Auto

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

Ejecuta "bun add @capgo/capacitor-auto" (o "npm install @capgo/capacitor-auto"), luego ejecuta "bunx cap sync" para que los proyectos de iOS y Android detecten el code nativo. Impórtalo desde "@capgo/capacitor-auto" en el code de tu app.

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

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

¿Qué versión de Capacitor soporta @capgo/capacitor-auto?

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

¿Es @capgo/capacitor-auto gratuito y open source?

Sí. El code fuente es público en GitHub en https://github.com/Cap-go/capacitor-auto/ y el paquete es gratuito en npm. Los reportes de bugs y pull requests son bienvenidos.

¿Puedo actualizar code que usa Auto sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Lanza cambios con Auto sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo