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

Automático Plugin Capacitor

Conecta aplicaciones Capacitor con CarPlay y Android Auto para comunicación de dos vías con plantillas de superficies

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

Usando @capgo/capacitor-auto

@capgo/capacitor-auto conecta una aplicación Capacitor a superficies de CarPlay y Android Auto aprobadas. Tu aplicación envía una pequeña lista de plantillas a la pantalla del coche, y la pantalla del coche envía acciones seleccionadas de regreso a JavaScript.

Es 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' },
        },
      ],
    },
  ],
});

Escucha acciones del conductor

await Auto.addListener('carAction', async (event) => {
  if (event.id === 'open-main-door') {
    await openGarageDoor(event.payload?.doorId);
  }
});

Observa 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

Requiere una autorización de Apple aprobada para tu categoría de aplicación. Agrega la configuración de la escena de CarPlay descrita en el Requisitos de Android 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. CarAppServicedeclara la template capacidad, y por defecto se utiliza el IOT documentos de configuración de Android Documentación de configuración de Android Si su aplicación necesita otra categoría de Android Auto.

Guía de diseño

Utilice la superficie del coche para acciones cortas y predecibles:

  • Filas de estado
  • Comandos de un solo toque
  • Confirmaciones seguras para el conductor
  • Pase de estado simple desde la aplicación del teléfono

Keep complex flows in the phone UI and use carAction Eventos como disparadores de intenciones nativas.

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

Si está utilizando Usando @capgo/capacitor-auto planear el comportamiento de medios y interfaz nativa, conectarlo con @capgo/capacitor-auto para el detalle de implementación en @capgo/capacitor-auto Getting Started para el detalle de implementación en Iniciación Usando @capgo/capacitor-live-actividades para la capacidad nativa en Usando @capgo/capacitor-live-actividades @capgo/capacitor-live-actividades para el detalle de implementación en @capgo/capacitor-live-actividades, y Usando @capgo/capacitor-video-player para la capacidad nativa en Usando @capgo/capacitor-video-player

FAQ

FAQ del plugin automático

How do I install the Auto plugin in a aplicación Capacitor?

Run "bun add @capgo/capacitor-auto" (o "npm install @capgo/capacitor-auto"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen los nativos code. Importa desde "@capgo/capacitor-auto" en tu aplicación code.

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

Sí. 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.

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

Los plugins Capgo siguen la versión mayor de Capacitor: utiliza 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 del GitHub lista las versiones mantenidas.

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

Sí. El código fuente code está disponible 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 los nativos code, 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 enviarlos 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 cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Inicia con Capgo