Zum Hauptinhalt springen
@capgo/capacitor-uwb Device-APIs Open Source

UWB Capacitor Plugin

Ultra-Wideband-Ranging für Distanz und Richtung zwischen Peers auf iOS Nearby Interaction und Android Jetpack UWB

Installieren

bun add @capgo/capacitor-uwb bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-uwb
  • pnpm add @capgo/capacitor-uwb
  • yarn add @capgo/capacitor-uwb

Anleitung

So nutzt du UWB in Capacitor

Auf dem Gerät testen

Lade die Capgo App herunter und scanne den QR code.

UWB-Plugin-Vorschau QR code

Nutzung von @capgo/capacitor-uwb

Capacitor Plugin für Ultra-Wideband (UWB) Ranging auf iOS und Android.

Installieren

bun add @capgo/capacitor-uwb
bunx cap sync

Was dieses Plugin bereitstellt

  • isAvailable - Prüfen, ob UWB unterstützt und aktuell verfügbar ist.
  • getDiscoveryToken - Das lokale Nearby Interaction Discovery-Token auf iOS abrufen.
  • startPeerSession - Eine iOS-Peer-Ranging-Session starten.
  • startControllerSession - Startet eine Android-Controller-Sitzung und gibt teilbare Parameter zurück.
  • startControleeSession - Startet eine Android-Controlee-Sitzung aus Controller-Parametern.
  • stopSession - Beendet die aktive Ranging-Sitzung.

Anwendungsbeispiel

Verfügbarkeit prüfen

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

const availability = await CapacitorUwb.isAvailable();

iOS Peer Ranging

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

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

Android Controller / Controlee

const controller = await CapacitorUwb.startControllerSession();

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

Vollständige Referenz

Weiter mit Using @capgo/capacitor-uwb

Wenn du es nutzt Nutzung von @capgo/capacitor-uwb Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-uwb für die Implementierungsdetails in @capgo/capacitor-uwb, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.

FAQ

FAQ zum UWB-Plugin

Wie installiere ich das UWB-Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-uwb" (oder "npm install @capgo/capacitor-uwb") aus und dann "bunx cap sync", damit die iOS- und Android-Projekte das native code übernehmen. Importiere es in deinem App-code aus "@capgo/capacitor-uwb".

Funktioniert @capgo/capacitor-uwb mit React, Vue und Angular?

Ja. UWB ist ein Capacitor-Paket und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-uwb?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-uwb kostenlos und Open Source?

Ja. Der Quell-code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-uwb/ verfügbar und das Paket kann kostenlos von npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code aktualisieren, das UWB verwendet, ohne eine App-Store-Prüfung?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

UWB-Änderungen veröffentlichen, ohne auf die App-Prüfung zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo