Android-Setup
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Genutztes Android-Native-System
Abschnitt mit dem Titel „Verwendetes Android-Nativesystem“Auf Android verwendet dieses Plugin Jetpack UWB von androidx.core.uwb.
Anforderungen
Abschnitt „Voraussetzungen“- Android 12+
- Gerät mit UWB-Hardware
- UWB in den Systemeinstellungen aktiviert
Manifest und Berechtigungen
Abschnitt mit dem Titel „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 zusätzlichen Manifeständerungen erforderlich.
Controller-Flow
Abschnitt mit dem Titel „Controller-Flow“import { CapacitorUwb } from '@capgo/capacitor-uwb';
const controller = await CapacitorUwb.startControllerSession();
// Share controller.rangingParameters and controller.localAddress out-of-bandWenn Sie die Adresse des Controlee bereits kennen, übergeben Sie sie beim Starten der Controller-Sitzung:
await CapacitorUwb.startControllerSession({ peerAddress: '<controlee-address-base64>',});Controlee-Flow
Abschnitt mit dem Titel „Controlee flow“await CapacitorUwb.startControleeSession({ rangingParameters: { sessionId: 12345, sessionKeyInfo: '<base64>', complexChannel: { channel: 9, preambleIndex: 10 }, peerAddress: '<controller-address-base64>', },});Events
Abschnitt „Events“rangingUpdatelöst Distanz- und Winkelmessungen aus, wenn verfügbar.sessionStateChangedlöst Lifecycle-Zustände aus, wie z. B.running,invalidated, undpeerDisconnected.
startControllerSession()undstartControleeSession()sind Android-spezifische APIs.- Das Plugin stellt kein BLE- oder Backend-Transportmittel zum Austausch von Ranging-Parametern bereit.