安卓设置

安卓原生系统使用

在安卓上，这个插件使用 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" />

大多数应用程序中不需要额外的清单更改。

控制器流程

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或后端传输来交换范围参数。