Auto plugin Capacitor

En utilisant @capgo/capacitor-auto

@capgo/capacitor-auto connecte une application Capacitor aux surfaces de CarPlay et Android Auto approuvées. Votre application envoie une petite liste de modèles à l'écran de la voiture, et l'écran de la voiture envoie les actions sélectionnées vers JavaScript.

C'est conçu pour des flux de travail sûrs et contrôlés par la politique. Il ne reflète pas votre WebView dans la voiture.

Installer et synchroniser

npm install @capgo/capacitor-auto
npx cap sync

Envoyer un modèl’à 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' },
        },
      ],
    },
  ],
});

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

Exigences iOS

CarPlay nécessite un droit approuvé par Apple pour votre catégorie d'application. Ajoutez la configuration de la scène CarPlay décrite dans le docs de configuration iOS and keep your car UI inside Apple-approved templates.

Exigences Android

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

Conseils de conception

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

• État des lignes
• Commandes d'un seul clic
• Confirmations sûres du pilote
• Passage d'état simple depuis l'application mobile

Keep complex flows in the phone UI and use carAction événements comme déclencheurs d'intention natifs.

Continuez à utiliser @capgo/capacitor-auto

Si vous utilisez Utilisez @capgo/capacitor-auto Pour planifier le comportement de médias et d'interface natives, connectez-l’avec @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 Prise en main, Utilisation de @capgo/capacitor-activités-en-ligne pour la capacité native dans Utilisation de @capgo/capacitor-activités-en-ligne, @capgo/capacitor-activités-en-ligne pour les détails d'implémentation dans @capgo/capacitor-activités-en-ligne, et Utilisation de @capgo/capacitor-joueurs-de-videos pour la capacité native dans Utilisation de @capgo/capacitor-joueurs-de-videos.