Salta al contenuto principale
@capgo/capacitor-auto API dei dispositivi Open source

Automatico Plugin Capacitor

Collega le tue app Capacitor con template CarPlay e Android Auto per la comunicazione bidirezionale in auto

Installa

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

Guida

Come usare Auto in Capacitor

Utilizzo di @capgo/capacitor-auto

@capgo/capacitor-auto Collega un'app Capacitor alle superfici template approvate di CarPlay e Android Auto. La tua app invia un piccolo template di elenco al display dell'auto, e il display dell'auto invia le azioni selezionate a JavaScript.

È progettato per flussi di lavoro sicuri per il conducente e controllati dalle policy. Non replica il tuo WebView nell'auto.

Installa e sincronizza

npm install @capgo/capacitor-auto
npx cap sync

Invia un template all'auto

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

Ascolta le azioni del conducente

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

Monitora lo stato della connessione

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

Requisiti iOS

CarPlay richiede un entitlement approvato da Apple per la categoria della tua app. Aggiungi la configurazione della scena CarPlay descritta in documenti di configurazione iOS e mantieni la UI per auto all'interno dei template approvati da Apple.

Requisiti Android

Android Auto utilizza AndroidX Car App Library. Il plugin include un CarAppService, dichiara la template capability e predefinisce la IOT categoria. Rivedi il Documentazione setup Android se la tua app richiede un'altra categoria Android Auto.

Linee guida di design

Usa la superficie dell'auto per azioni brevi e prevedibili:

  • righe di stato
  • comandi con un solo tocco
  • conferme sicure per il conducente
  • semplice passaggio di stato dall'app sul telefono

Mantieni i flussi complessi nell'UI del telefono e usa carAction gli eventi come trigger di intent nativi.

Continua da Usare @capgo/capacitor-auto

Se stai usando Utilizzo di @capgo/capacitor-auto per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-auto per i dettagli di implementazione in @capgo/capacitor-auto, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.

FAQ

FAQ plugin Auto

Come installo il plugin Auto in un'app Capacitor?

Esegui "bun add @capgo/capacitor-auto" (o "npm install @capgo/capacitor-auto"), poi lancia "bunx cap sync" così i progetti iOS e Android rilevano il code nativo. Importalo da "@capgo/capacitor-auto" nel code della tua app.

@capgo/capacitor-auto funziona con React, Vue e Angular?

Sì. Auto è un pacchetto Capacitor, quindi funziona con qualsiasi web framework che gira dentro Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-auto?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-auto è gratuito e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-auto/ e il pacchetto si installa gratuitamente da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Auto senza la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Pubblica modifiche Auto senza aspettare la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo