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() and startPeerSession() iOS-only API仅适用于iOS设备。
• 相机辅助功能在iOS 16+支持的设备上可用。