Anleitung zum Starten

Installieren

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

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 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 Sitzung

1. Der Controller ruft startControllerSession() und teilt die zurückgegebenen rangingParameters und localAddress.
2. Der Kontrolleur baut sein eigenes rangingParameters, indem der Controller verwendet wird localAddress als peerAddress.
3. Der Kontrolleur ruft startControleeSession({ rangingParameters }).
4. Optionell kann peerAddress in den Controller einfließen, 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();

Quellwahrheit

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.