iOS 设置

iOS 本地系统使用

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

要求

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

Xcode 配置

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() 信任 startPeerSession() 仅适用于 iOS 的 API。
• 相机辅助功能在 iOS 16+ 上可用，具体取决于设备支持情况。