Android 配置

使用的 Android 原生系统

在 Android 上，此插件使用 Jetpack UWB 与 androidx.core.uwb.

环境要求

• Android 12+
• 具备 UWB 硬件的设备
• 系统设置中已启用 UWB

Manifest 与权限

该插件声明：

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

大多数应用无需额外修改 Manifest。

控制端流程

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

const controller = await CapacitorUwb.startControllerSession();

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

如果您已知被控端地址，请在启动控制器会话时传入：

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

被控端流程

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

活动

• rangingUpdate 在可用时发出距离和角度测量值。
• sessionStateChanged 发出生命周期状态，例如 running, invalidated，以及 peerDisconnected.

备注

• startControllerSession() 和 startControleeSession() 是仅限 Android 的 API。
• 该插件不提供用于交换测距参数的 BLE 或后端传输方式。