Android-Setup

Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.

Genutztes Android-Native-System

Unter Android nutzt dieses Plugin Jetpack UWB von androidx.core.uwb.

Anforderungen

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

Manifest und Berechtigungen

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 weiteren Änderungen am Manifest nötig.

Controller-Flow

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

const controller = await CapacitorUwb.startControllerSession();

// Share controller.rangingParameters and controller.localAddress out-of-band

Wenn die Controlee-Adresse bereits bekannt ist, übergeben Sie diese beim Starten der Controller-Session:

await CapacitorUwb.startControllerSession({
  peerAddress: '<controlee-address-base64>',
});

Controlee-Flow

await CapacitorUwb.startControleeSession({
  rangingParameters: {
    sessionId: 12345,
    sessionKeyInfo: '<base64>',
    complexChannel: { channel: 9, preambleIndex: 10 },
    peerAddress: '<controller-address-base64>',
  },
});

Events

rangingUpdate gibt Entfernungs- und Winkelmessungen aus, sobald diese verfügbar sind.
sessionStateChanged gibt Lifecycle-Zustände aus wie running, invalidated, und peerDisconnected.

Notizen

startControllerSession() und startControleeSession() sind nur für Android verfügbare APIs.
Das Plugin bietet keinen BLE- oder Backend-Transport für den Austausch von Ranging-Parametern.