跳转到正文

Android 配置

GitHub

在 Android 上,此插件使用 Jetpack UWB 来自 androidx.core.uwb.

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

该插件声明:

<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 或后端传输。