Vai direttamente al contenuto principale
Torna ai plugin
@capgo/capacitor-auto
Guida
@capgo/capacitor-auto

Auto

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

Guida

Tutoriale su Auto

Testare sul dispositivo

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

Anteprima QR del plugin Auto code

Utilizza @capgo/capacitor-auto

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

E' costruito 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

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

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

Guarda 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 nel Istruzioni di configurazione per iOS E conserva l'interfaccia utente del tuo veicolo all'interno di modelli approvati da Apple.

Istruzioni di configurazione per Android

Android Auto utilizza la libreria di applicazioni per auto AndroidX. Il plugin include un CarAppServicedeclara la template capacità, e si attiva per impostazione predefinita nella IOT categoria. Consulta le Istruzioni di configurazione per Android se il tuo app ha bisogno di un'altra categoria di Android Auto.

Linee guida per la progettazione

Utilizza la superficie del veicolo per azioni brevi e prevedibili:

  • righe di stato
  • comandi di un solo tocco
  • conferme sicure del driver
  • passaggio di stato semplice dall'app di telefono

Mantieni i flussi complessi nell'interfaccia di telefono e utilizza carAction gli eventi come trigger di intent nativi.

Continua dall'uso di @capgo/capacitor-auto

Se stai utilizzando Utilizza @capgo/capacitor-auto per pianificare il comportamento di media e interfaccia nativa, connettilo con @capgo/capacitor-auto per i dettagli di implementazione in @capgo/capacitor-auto Iniziare per i dettagli di implementazione in Getting Started, Utilizzando @capgo/capacitor-live-attività per la capacità nativa in Utilizzando @capgo/capacitor-live-attività, @capgo/capacitor-live-attività per i dettagli di implementazione in @capgo/capacitor-live-attività, e Utilizzando @capgo/capacitor-player-video per la capacità nativa in Utilizzando @capgo/capacitor-player-video.