Android 配置
复制包含安装步骤和该插件完整 Markdown 指南的配置 prompt。
使用的 Android 原生系统
标题为“使用的 Android 原生系统”的章节在 Android 上,此插件使用 Jetpack UWB 来自 androidx.core.uwb.
- Android 12+
- 具备 UWB 硬件的设备
- 系统设置中已启用 UWB
Manifest 与权限
标题为“Manifest 与权限”的章节该插件声明:
<uses-permission android:name="android.permission.UWB_RANGING" /><uses-feature android:name="android.hardware.uwb" android:required="false" />大多数应用无需额外修改 manifest。
Controller 流程
标题为“Controller 流程”的章节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 或后端传输。