Auto Capacitor Plugin

Verwendung von @capgo/capacitor-auto

@capgo/capacitor-auto connects a Capacitor app to approved CarPlay and Android Auto template surfaces. Your app sends a small list template to the car display, and the car display sends selected actions back to JavaScript.

Es ist für sicherheitskonforme, politikgesteuerte Workflows entwickelt. Es spiegelt Ihren WebView nicht in das Fahrzeug wider.

Installieren und synchronisieren

npm install @capgo/capacitor-auto
npx cap sync

Hören Sie auf Fahreraktionen

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

Überwachen Sie den Zustand der Verbindung

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

iOS-Anforderungen

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

__CAPGO_KEEP_1__-Auto

CarPlay erfordert eine von Apple genehmigte Berechtigung für Ihre App-Kategorie. Fügen Sie der CarPlay-Szenenkonfiguration, die in den iOS-Einrichtungsdokumenten und halten Sie Ihre Fahrzeug-UI innerhalb von Apple-zugelassenen Vorlagen.

Android-Anforderungen

Android Auto verwendet die AndroidX Car App Library. Der Plugin enthält CarAppService, erklärt die template Kapazität, und setzt standardmäßig die IOT Kategorie. Überprüfen Sie die Android-Einrichtungsdokumente , wenn Ihre App eine andere Android Auto-Kategorie benötigt.

Entwurfsleitfaden

Verwenden Sie die Fahrzeugoberfläche für kurze, vorhersehbare Aktionen:

• Statuszeilen
• Einzeldruck-Befehle
• Fahrer-sichere Bestätigungen
• Einfache Zustandsübergabe vom Telefon-App

Halten Sie komplexe Flüsse in der Telefon-UI und verwenden Sie carAction Events als native Intent-Auslöser.

Halten Sie es einfach, @capgo/capacitor-auto zu verwenden

Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-auto verwenden Verwendung von @capgo/capacitor-auto um native Medien- und Benutzeroberflächengestaltung zu planen, verbinden Sie es mit Using @capgo/capacitor-auto für die Implementierungsdetails in @capgo/capacitor-auto, Getting Started für die Implementierungsdetails in Einstieg Mit @capgo/capacitor-live-aktivitäten für die native Fähigkeit in Mit @capgo/capacitor-live-aktivitäten @capgo/capacitor-live-aktivitäten für die Implementierungsdetails in @capgo/capacitor-live-aktivitäten und Mit @capgo/capacitor-video-player für die native Fähigkeit in Mit @capgo/capacitor-video-player