Auto Plugin Capacitor

Utiliser @capgo/capacitor-auto

@capgo/capacitor-auto connecte une app Capacitor à des surfaces de templates approuvées pour CarPlay et Android Auto. Votre app envoie un petit template de liste à l'écran du véhicule, et celui-ci renvoie les actions sélectionnées au JavaScript.

Il est conçu pour des workflows sécurisés pour le conducteur et contrôlés par des politiques. Il ne reflète pas votre WebView dans la voiture.

Installer et synchroniser

npm install @capgo/capacitor-auto
npx cap sync

Envoyer un template à 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' },
        },
      ],
    },
  ],
});

Écouter les actions du conducteur

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

Surveiller l'état de la 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);
});

Prérequis iOS

CarPlay nécessite un entitlement approuvé par Apple pour votre catégorie d'application. Ajoutez la configuration de scène CarPlay décrite dans la doc de configuration iOS et maintenez votre interface voiture dans les templates approuvés par Apple.

Prérequis Android

Android Auto utilise la bibliothèque AndroidX Car App. Le plugin inclut un CarAppService, déclare la template capacité, et utilise par défaut la IOT catégorie. Consultez la Docs de configuration Android si votre application nécessite une autre catégorie Android Auto.

Conseils de design

Utilisez l'interface voiture pour des actions courtes et prévisibles :

• lignes de statut
• commandes en un clic
• confirmations sécurisées pour le conducteur
• transfert d'état simple depuis l'application mobile

Keep complex flows in the phone UI and use carAction events as native intent triggers.

Continuer après l'utilisation de @capgo/capacitor-auto

Si vous utilisez Utiliser @capgo/capacitor-auto pour planifier le comportement des médias et de l'interface natifs, connectez-l’à @capgo/capacitor-auto pour les détails d'implémentation dans @capgo/capacitor-auto, Prise en main pour les détails d'implémentation dans Getting Started Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities @capgo/capacitor-live-activities pour les détails d'implémentation dans @capgo/capacitor-live-activities, et Utiliser @capgo/capacitor-video-player pour la fonctionnalité native dans Utilisation de @capgo/capacitor-video-player.