Configurazione Android

Utilizza il sistema nativo Android

Sulla piattaforma Android, questo plugin utilizza Jetpack UWB da androidx.core.uwb.

Requisiti

• Android 12+
• Dispositivo con hardware UWB
• UWB abilitato nelle impostazioni del sistema

Manifesto e autorizzazioni

Il plugin dichiara:

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

Non sono richieste modifiche aggiuntive al manifesto in quasi tutti gli app

Ciclo del controllore

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

const controller = await CapacitorUwb.startControllerSession();

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

Se già conosci l'indirizzo del controlato, passalo quando si avvia la sessione del controllore:

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

Ciclo del controlato

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

Eventi

• rangingUpdate emette misurazioni di distanza e angolo quando disponibili.
• sessionStateChanged emette stati di ciclo di vita come running, invalidated, e peerDisconnected.

Note

• startControllerSession() e startControleeSession() sono API Android esclusivi.
• Il plugin non fornisce trasporto BLE o backend per lo scambio di parametri di rilevamento.