iOS 配置

使用的 iOS 原生系统

在 iOS 上，此插件使用 附近交互 来自 NearbyInteraction framework。

环境要求

• iOS 15+
• 具备 UWB 硬件的真机
• 在 Xcode 中启用 Nearby Interaction 能力

Xcode 配置

1. 在 Xcode 中打开你的 iOS App target。
2. 前往 Signing & Capabilities.
3. 点击 + Capability 并添加 附近交互.
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+ 可使用相机辅助功能。