System Capacitor Plugin

Verwendung von @capgo/capacitor-auto

@capgo/capacitor-auto verbindet eine Capacitor App mit freigegebenen CarPlay- und Android Auto-Templates. Deine App sendet eine kleine Liste an das Display im Auto, und das Display sendet ausgewählte Aktionen zurück an JavaScript.

Es wurde für fahrersichere, richtlinienbasierte Workflows entwickelt. Es spiegelt nicht einfach deine WebView ins Auto.

Installieren und synchronisieren

npm install @capgo/capacitor-auto
npx cap sync

Ein Template an das Auto senden

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

Auf Fahreraktionen lauschen

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

Verbindungsstatus überwachen

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

iOS-Anforderungen

CarPlay erfordert ein von Apple genehmigtes Entitlement für deine App-Kategorie. Füge die CarPlay-Szenenkonfiguration hinzu, wie in den iOS-Setup-Docs beschrieben, und nutze für dein Car-UI ausschließlich Apple-konforme Templates.

Android-Anforderungen

Android Auto nutzt die AndroidX Car App Library. Das Plugin enthält ein CarAppService, deklariert die template -Fähigkeit und nutzt standardmäßig die IOT -Kategorie. Überprüfe die Android Setup-Docs falls deine App eine weitere Android Auto-Kategorie benötigt.

Design-Leitfaden

Nutze das Car-Interface für kurze, vorhersehbare Aktionen:

• Statuszeilen
• One-Tap-Befehle
• fahrer-sichere Bestätigungen
• einfacher State-Handoff von der Phone-App

Halte komplexe Flows in der Phone-UI und nutze carAction Events als native Intent-Trigger.

Weiter mit @capgo/capacitor-auto

Wenn du es nutzt Verwendung von @capgo/capacitor-auto , um natives Media- und Interface-Verhalten zu planen, verbinde es mit @capgo/capacitor-auto für die Implementierungsdetails in @capgo/capacitor-auto, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-live-activities verwenden für die native Funktion in „@capgo/capacitor-live-activities verwenden“, @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-activities und Verwendung von @capgo/capacitor-video-player für die native Funktionalität in „Verwendung von @capgo/capacitor-video-player.“