Configuration Android

Système natif Android utilisé

Sur Android, ce plugin utilise Jetpack UWB à partir de androidx.core.uwb.

Requisitos

• Android 12+
• Un appareil avec matériel UWB
• UWB activé dans les paramètres du système

Manifeste et autorisations

Le plugin déclare :

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

Aucune modification supplémentaire du manifeste n'est requise dans la plupart des applications.

Flux de contrôleur

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

const controller = await CapacitorUwb.startControllerSession();

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

Si vous connaissez déjà l'adresse du contrôlé, passez-la lors de la création de la session de contrôleur :

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

Flux de contrôlé

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

Événements

• rangingUpdate émet des mesures de distance et d'angle lorsque disponibles.
• sessionStateChanged émet les états de cycle de vie tels que running, invalidated, et peerDisconnected.

Notes

• startControllerSession() et startControleeSession() sont des API Android uniquement.
• Le plugin ne fournit pas de transport BLE ou de backend pour échanger des paramètres de balayage.