Prise en Main

Installer

Vous pouvez utiliser notre configuration assistée par l'IA pour installer le plugin. Ajoutez les Capgo compétences à votre outil IA à l'aide de la commande suivante :

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Ensuite, utilisez la prompt suivante :

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-uwb` plugin in my project.

If vous préférez la configuration manuelle, installez le plugin en exécutant les commandes suivantes et suivez les instructions spécifiques au plateforme ci-dessous:

bun add @capgo/capacitor-uwb
bunx cap sync

Importer

import { CapacitorUwb } from '@capgo/capacitor-uwb';

Vérifier la disponibilité

const availability = await CapacitorUwb.isAvailable();

if (!availability.supported) {
  console.log('This device does not support UWB.');
}

Séance de peer iOS

1. Appeler getDiscoveryToken() sur les deux appareils.
2. Échangez les jetons base64 retournés hors bande.
3. Commencez à émettre avec le jeton pair.

const { discoveryToken } = await CapacitorUwb.getDiscoveryToken();

await CapacitorUwb.startPeerSession({
  peerDiscoveryToken: '<peer-token-base64>',
});

Voir configuration iOS pour les exigences de capacité et de droits.

Session du contrôleur / Contrôlée

1. Le contrôleur appelle startControllerSession() et partage les jetons retournés rangingParameters et localAddress.
2. Les contrôleés construisent leur propre rangingParameters, en utilisant le contrôleur localAddress comme peerAddress.
3. Les contrôleés appellent startControleeSession({ rangingParameters }).
4. Optionnellement passer peerAddress au contrôleur une fois que l'adresse du contrôleé est connue.

const controller = await CapacitorUwb.startControllerSession();

await CapacitorUwb.startControleeSession({
  rangingParameters: {
    ...controller.rangingParameters,
    peerAddress: controller.localAddress,
  },
});

Voir Configuration Android pour les exigences de matériel et de permissions.

Écouter les mises à jour

await CapacitorUwb.addListener('rangingUpdate', (event) => {
  console.log(event.distanceMeters, event.direction);
});

await CapacitorUwb.addListener('sessionStateChanged', (event) => {
  console.log(event.state, event.reason);
});

Arrêter La Session

await CapacitorUwb.stopSession();

Source De Vérité

Cette page est générée à partir du plugin’s src/definitions.tsMettez à jour les définitions TypeScript et exécutez bun run docgen dans le référentiel du plugin pour rafraîchir les documents générés API.