Anfangen

Installieren

Sie können unsere AI-gestützte Einrichtung verwenden, um das Plugin zu installieren. Fügen Sie die Capgo-Fähigkeiten zu Ihrem KI-Tool hinzu, indem Sie die folgende Anweisung verwenden:

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

Dann verwenden Sie die folgende Anweisung:

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

Wenn Sie eine manuelle Einrichtung bevorzugen, installieren Sie das Plugin, indem Sie die folgenden Befehle ausführen und die darunter angegebenen plattform-spezifischen Anweisungen befolgen:

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. Aufrufen getDiscoveryToken() auf beiden Geräten.
2. Ersetzen Sie die zurückgegebenen Base64-Tokens außerhalb des Bandbreiten.
3. Starten Sie das Rangieren mit dem Peer-Token.

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

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

Siehe iOS-Einrichtung für Anforderungen an Fähigkeiten und Berechtigungen.

Android Controller / Controlee Session

1. Der Controller ruft startControllerSession() und teilt die zurückgegebenen rangingParameters und (und, im Kontext von Capgo Marketing-Website, als kurzer UI-Label oder Navigationselement, im Bereich Vertrauen auf der Seite trust.astro, mit der Nachrichtschlüssel `and` (Und)) localAddress.
2. Der Kontrolleur baut sein eigenes rangingParameters, indem der Controller localAddress als peerAddress.
3. Der Kontrolleur ruft startControleeSession({ rangingParameters }).
4. Optionell kann man peerAddress in den Controller einfügen, sobald die Adresse des Kontrolleurs 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 Updates lauschen

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

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

Sitzung beenden

await CapacitorUwb.stopSession();

Quelle der Wahrheit

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