Installation

Copiez un prompt de configuration avec les étapes d'installation et le guide Markdown complet pour ce plugin.

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-auto`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/auto/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

Installez le package
Fenêtre de terminal
```
npm i @capgo/capacitor-auto
```
Synchroniser les projets natifs
Fenêtre de terminal
```
npx cap sync
```

Définir le modèle racine de la voiture

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

Gérer les actions de la voiture

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

Suivre l'état de connexion

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

État vide

Définir emptyText lorsque le modèle n'a pas de lignes :

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

Envoyer des messages de pont

Utiliser sendMessage pour les messages de pont définis par l'application :

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

Configuration de la plateforme

Suivre les Configuration iOS page pour les notes sur la scène CarPlay et les autorisations.
Suivre les Configuration Android Page de la catégorie Android Auto et notes de manifeste.

Continuez de l'installation initiale

Si vous utilisez Installation initiale pour planifier le travail de plugin natif, connectez-le à En utilisant @capgo/capacitor-auto pour la capacité native dans En utilisant @capgo/capacitor-auto, Capgo Répertoire des plugins pour le flux de travail du produit dans Capgo Répertoire des plugins, Capacitor Plugins par Capgo pour les détails d'implémentation dans Capacitor Plugins par Capgo, Ajouter ou Mettre à Jour les Plugins pour les détails d'implémentation dans Ajouter ou Mettre à Jour les Plugins, et Alternatives de Plugins Entreprise Ionic pour le flux de travail du produit dans Alternatives de Plugins Entreprise Ionic.