Einstieg

Installieren

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie den Capgo-Fähigkeiten Ihre AI-Tool mithilfe der folgenden Befehl hinzu:

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

Dann verwenden Sie die folgende Anfrage:

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

Wenn Sie die manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und folgen Sie den unten aufgeführten plattform-spezifischen Anweisungen:

bun add @capgo/capacitor-uwb
bunx cap sync

Importieren

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

Verfügbarkeit überprüfen

const availability = await CapacitorUwb.isAvailable();

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

iOS-Peer-Sitzung

1. Anrufen getDiscoveryToken() auf beiden Geräten.
2. Ersetzen Sie die zurückgegebenen Base64-Tokens außerhalb des Bandes.
3. Mit dem Peer-Token beginnen, das Rang zu erstellen.

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

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

Weiterlesen iOS-Einrichtung für Fähigkeiten und Berechtigungsanforderungen.

Android Controller / Controlee-Sitzung

1. Der Controller ruft startControllerSession() und teilt die zurückgegebene rangingParameters und localAddress.
2. Der Controlee baut sein eigenes rangingParameters, wobei der Controller localAddress als peerAddress.
3. Der Controlee ruft startControleeSession({ rangingParameters }).
4. Optionell kann peerAddress zum Controller übergeben werden, sobald die Adresse des Controlees bekannt ist.

const controller = await CapacitorUwb.startControllerSession();

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

Siehe Android-Einrichtung für Hardware- und Berechtigungsanforderungen.

Für Aktualisierungen lauschen

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

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

Die Sitzung beenden

await CapacitorUwb.stopSession();

Quelle der Wahrheit

Diese Seite wurde aus dem Plugin-Modul generiert. src/definitions.ts. Aktualisiere die TypeScript-Definitionen und führe bun run docgen in dem Plugin-Repository aus, um die generierten API Dokumente zu aktualisieren.