Configuración de Android

Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.

Sistema nativo de Android utilizado

En Android, este plugin utiliza Jetpack UWB de los androidx.core.uwb.

Requisitos

Android 12+
Dispositivo con hardware UWB
UWB activado en los ajustes del sistema

Manifiesto y permisos

El plugin declara:

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

La mayoría de las apps no requieren cambios en el manifest.

Flujo del controlador

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

const controller = await CapacitorUwb.startControllerSession();

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

Si ya conoces la dirección del controlee, pásala al iniciar la sesión del controller:

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

Flujo del dispositivo controlado

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

Eventos

rangingUpdate emite mediciones de distancia y ángulo cuando están disponibles.
sessionStateChanged emite estados de ciclo de vida como running, invalidated, y peerDisconnected.

Notas

startControllerSession() y startControleeSession() son APIs exclusivas de Android.
El plugin no proporciona BLE ni transporte de backend para el intercambio de parámetros de ranging.