Getting Started

Installation

Sie können unser AI-gestütztes Setup verwenden, um das Plugin zu installieren. Fügen Sie die Capgo-Fähigkeiten Ihrem AI-Tool mit der folgenden Befehl hinzu:

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 eine manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und die unten angegebenen Plattform-spezifischen Anweisungen befolgen:

1. Installieren Sie das Paket

   npm i @capgo/capacitor-auto

2. Synchronisieren Sie native Projekte

   npx cap sync

3. Setzen Sie die root car Template

   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. Auto-Fahrzeugaktionen verwalten

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

5. Verbindungszustand verfolgen

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

Car-UIs werden durch Richtlinien gesteuert

CarPlay und Android Auto erlauben keine willkürliche Webbiewiedergabe. Halten Sie die Fahrzeugaktionen kurz, sicher für den Fahrer und stimmen Sie sie mit der von Apple oder Google genehmigten App-Kategorie überein.

Leerzustand

Setzen emptyText wenn das Template keine Zeilen hat:

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

Sende Brückenmeldungen

Verwende sendMessage für anwendungsdefinierte native Brückenmeldungen:

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

Plattformseinstellungen

• Folge den iOS-Einstellungen der Seite für CarPlay-Szenario- und Berechtigungsangaben.
• Folge den Android-Einstellungen Seite für die Android Auto-Kategorie und Manifesthinweise.

Fortsetzung von Getting Started

Wenn Sie native Plugins verwenden Getting Started um native Plugin-Arbeit zu planen, verbinden Sie es mit Verwenden Sie @capgo/capacitor-auto zur Verbindung für die native Fähigkeit in Verwenden Sie @capgo/capacitor-auto Capgo-Plugin-Verzeichnis zur Produktworkflow in Capgo-Plugin-Verzeichnis Capacitor-Plugins von Capgo zur Implementierungsdetail in Capacitor-Plugins von Capgo Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren, und Ionic Enterprise-Plugin-Alternativen für den Produktworkflow in Ionic Enterprise-Plugin-Alternativen.