Getting Started

Installation

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie die Capgo-Fähigkeiten zu Ihrem AI-Tool hinzu, indem Sie die folgende Befehlszeile verwenden:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Verwenden Sie dann die folgende Anfrage:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-auto` plugin in my project.

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und folgen Sie den unten aufgeführten Plattform-spezifischen Anweisungen:

1. Installieren Sie das Paket

   npm i @capgo/capacitor-auto

2. Synchronisiere native Projekte

   npx cap sync

3. Setze die Root-Car-Vorlage

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

4. Behandle Fahrzeugaktionen

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

5. Verfolge die Verbindungszustand

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

Fahrzeug-UIs werden durch Richtlinien gesteuert

CarPlay und Android Auto erlauben keine willkürlichen WebView-Wiederholungen. Halten Sie die Fahrzeugaktionen kurz, sicher für den Fahrer und in Einklang mit der von Apple oder Google genehmigten App-Kategorie.

Leerzustand

Setzen emptyText wenn das Template keine Zeilen hat:

await Auto.setRootTemplate({
  title: 'Garage',
  emptyText: 'No actions are available right now.',
  sections: [],
});

Bridgemeldungen senden

Verwenden sendMessage für anwendungseigene native Bridgemeldungen:

await Auto.sendMessage({
  type: 'status',
  payload: { online: true },
});

Plattformkonfiguration

• Folgen Sie der iOS-Einrichtung Seite für CarPlay-Szenario und Berechtigungsnotizen.
• Folgen Sie der Android-Einrichtung Seite für Android Auto-Kategorie und Manifestnotizen.

Bleiben Sie bei Getting Started

Wenn Sie native Plugin-Arbeit planen, Getting Started verbinden Sie es mit Mit @capgo/capacitor-auto für die native Fähigkeit in Mit @capgo/capacitor-auto Capgo Plugin-Ordner für den Produktworkflow in Capgo Plugin-Ordner Capacitor Plugins von Capgo für die Implementierungsdetail in Capacitor Plugins von Capgo, Hinzufügen oder Aktualisieren von Plugins für die Implementierungsdetail in Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin Alternativen für den Produktworkflow in Ionic Enterprise Plugin Alternativen.