Saltare al contenuto principale
Torna ai plugin
@capgo/capacitor-auto
Tutorial
@capgo/capacitor-auto

Auto

Collega le app Capacitor con le superfici di CarPlay e Android Auto per una comunicazione bidirezionale in auto

Guida

Tutoriale su Auto

Testa sul dispositivo

Scarica l'app Capgo, poi scansa il codice QR code.

Anteprima del plugin QR code

Utilizza @capgo/capacitor-auto

@capgo/capacitor-auto connette un'applicazione Capacitor a superfici di CarPlay e Android Auto approvate. La tua app invia una piccola lista di template alla schermata del veicolo, e la schermata del veicolo invia azioni selezionate di ritorno a JavaScript.

È progettato per flussi di lavoro sicuri per il conducente, controllati da politiche. Non riflette il tuo WebView nella vettura.

Installa e sincronizza

npm install @capgo/capacitor-auto
npx cap sync

Invia un template alla vettura

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 azioni del conducente

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

Vigila lo stato di 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'autorizzazione Apple approvata per la tua categoria di app. Aggiungi la configurazione della scena di CarPlay descritta nei documenti di configurazione iOS e mantieni la tua interfaccia utente di vettura all'interno di template Apple approvati.

Requisiti Android

Android Auto utilizza la libreria AndroidX Car App. Il plugin include un CarAppServiceche dichiara il template capacità, e si attiva per impostazione predefinita sul IOT categoria. Verifica i documenti di configurazione Android se il tuo app richiede un'altra categoria di Android Auto. Linee guida per la progettazione

Utilizza la superficie del veicolo per azioni brevi e predittibili:

righe di stato

  • comandi a un solo tocco
  • conferme sicure per il conducente
  • Requisiti Android
  • trasferimento di stato semplice da parte dell'app del telefono

Tenere i flussi complessi nell'interfaccia del telefono e utilizzare carAction gli eventi come trigger di intent native.

Continua da Utilizzo di @capgo/capacitor-auto

Se stai utilizzando Utilizzo di @capgo/capacitor-auto per pianificare il comportamento di media e interfaccia nativa, collegalo con @capgo/capacitor-auto per i dettagli di implementazione in @capgo/capacitor-auto, Guida per l'uso per i dettagli di implementazione in Guida per l'uso, Utilizzo di @capgo/capacitor-live-activities per la capacità nativa in Utilizzare @capgo/capacitor-live-attività @capgo/capacitor-live-attività per il dettaglio di implementazione in @capgo/capacitor-live-attività, e Utilizzare @capgo/capacitor-video-player per la capacità nativa in Utilizzare @capgo/capacitor-video-player.