Vai direttamente al contenuto principale
Indietro 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

Tutorial su Auto

Testa sul dispositivo

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

Visualizza anteprima QR del plugin auto code

Usando @capgo/capacitor-auto

@capgo/capacitor-auto connette un'applicazione Capacitor alle superfici di template approvate di CarPlay e Android Auto. L'applicazione 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 la tua 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 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 nei documenti di configurazione iOS e mantieni la tua interfaccia utente della vettura all'interno dei template approvati da Apple.

Requisiti Android

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

Utilizza la superficie del veicolo per azioni brevi e prevedibili:

righe di stato

  • comandi a un solo tocco
  • conferme sicure per il conducente
  • Android Auto utilizza la libreria AndroidX Car App. Il plugin include un __CAPGO_KEEP_0__ , dichiara il __CAPGO_KEEP_1__ , e si attiva su il __CAPGO_KEEP_2__ categoria. Verifica i __CAPGO_KEEP_3__ documenti di configurazione Android se il tuo app richiede un'altra categoria di Android Auto.
  • trasferimento di stato semplice dalla app del telefono

Mantieni le flussi complessi nella UI del 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, collegalo con @capgo/capacitor-auto per i dettagli di implementazione in @capgo/capacitor-auto, Avvio per i dettagli di implementazione in Avvio, Utilizza @capgo/capacitor-live-activities For il nativo capgo/capacitor-live-attività, @capgo/capacitor-live-attività Per il dettaglio di implementazione in @capgo/capacitor-live-attività, e Utilizzando @capgo/capacitor-video-player Per il nativo capgo/capacitor-video-player.