iOS设置

iOS原生系统使用

在iOS上，这个插件使用 附近互动 来自 NearbyInteraction 框架。

需求

• 具有UWB硬件的物理设备
• 在Xcode中启用附近互动功能
• Xcode设置

iOS原生系统使用

1. 在 Xcode 中打开您的 iOS 应用程序目标。
2. 前往 签名和功能.
3. 点击 + 功能 并添加 附近交互.
4. 添加使用说明到 Info.plist:

<key>NSNearbyInteractionUsageDescription</key>
<string>This app uses Ultra Wideband to measure distance to nearby devices.</string>

客户端流程

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

const { discoveryToken } = await CapacitorUwb.getDiscoveryToken();

await CapacitorUwb.startPeerSession({
  peerDiscoveryToken: '<peer-token-base64>',
  isCameraAssistanceEnabled: false,
});

每个设备都 discoveryToken 使用您自己的传输层与其他设备进行通信。该插件不会为您执行发现或网络。

事件

• rangingUpdate 当有可用更新时会发出距离和方向的更新。
• sessionStateChanged 发出生命周期状态 running, suspended, invalidated, peerDisconnected.

注意

• getDiscoveryToken() 仅限iOS API。 startPeerSession() 和
• iOS 设备支持的摄像头辅助功能可在 iOS 16+ 上使用。