Zum Inhalt springen

Android-Setup

GitHub

Auf Android verwendet dieses Plugin Jetpack UWB von androidx.core.uwb.

  • Android 12+
  • Gerät mit UWB-Hardware
  • UWB in den Systemeinstellungen aktiviert

Das Plugin deklariert:

<uses-permission android:name="android.permission.UWB_RANGING" />
<uses-feature android:name="android.hardware.uwb" android:required="false" />

In den meisten Apps sind keine zusätzlichen Manifeständerungen erforderlich.

import { CapacitorUwb } from '@capgo/capacitor-uwb';
const controller = await CapacitorUwb.startControllerSession();
// Share controller.rangingParameters and controller.localAddress out-of-band

Wenn Sie die Adresse des Controlee bereits kennen, übergeben Sie sie beim Starten der Controller-Sitzung:

await CapacitorUwb.startControllerSession({
peerAddress: '<controlee-address-base64>',
});
await CapacitorUwb.startControleeSession({
rangingParameters: {
sessionId: 12345,
sessionKeyInfo: '<base64>',
complexChannel: { channel: 9, preambleIndex: 10 },
peerAddress: '<controller-address-base64>',
},
});
  • rangingUpdate löst Distanz- und Winkelmessungen aus, wenn verfügbar.
  • sessionStateChanged löst Lifecycle-Zustände aus, wie z. B. running, invalidated, und peerDisconnected.
  • startControllerSession() und startControleeSession() sind Android-spezifische APIs.
  • Das Plugin stellt kein BLE- oder Backend-Transportmittel zum Austausch von Ranging-Parametern bereit.