Aller au contenu principal
@capgo/capacitor-auto API de l'appareil Open source

Auto Plugin Capacitor

Reliez vos applications Capacitor aux interfaces CarPlay et Android Auto pour une communication bidirectionnelle avec le véhicule

Installer

bun add @capgo/capacitor-auto bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-auto
  • pnpm add @capgo/capacitor-auto
  • yarn add @capgo/capacitor-auto

Guide

Comment utiliser Auto dans 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 les docs de configuration iOS et gardez votre interface voiture dans les templates approuvés par Apple.

Prérequis Android

Android Auto utilise AndroidX Car App Library. Le plugin inclut un CarAppService, déclare la template capacité, et utilise par défaut la IOT catégorie. Consultez les Docs de configuration Android si votre app a besoin d'une autre catégorie Android Auto.

Conseils de design

Utilisez la surface voiture pour des actions courtes et prévisibles :

  • lignes de statut
  • commandes en un tap
  • confirmations sûres pour le conducteur
  • transfert d'état simple depuis l'app mobile

Gardez les flux complexes dans l'UI du téléphone et utilisez carAction events as native intent triggers.

Continuer depuis « Utiliser @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 le détail 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.

FAQ

FAQ du plugin Auto

Comment installer le plugin Auto dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-auto » (ou « npm install @capgo/capacitor-auto »), puis lancez « bunx cap sync » pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis « @capgo/capacitor-auto » dans votre code.

Est-ce que @capgo/capacitor-auto fonctionne avec React, Vue et Angular ?

Oui. Auto est un package Capacitor, il fonctionne donc avec n'importe quel framework web qui tourne dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et du JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-auto ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-auto est gratuit et open source ?

Oui. Le code source est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-auto/ et le package s'installe gratuitement depuis npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Auto sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements Auto sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo