跳过内容
Capgo - Capacitor 应用程序的实时更新 Capgo

iOS设置

GitHub

iOS 原生系统使用

标题为“iOS 原生系统使用”

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

需求

标题：需求
  • iOS 15+
  • 具有 UWB 硬件的物理设备
  • 在 Xcode 中启用附近交互功能

Xcode 配置

在 Xcode 中打开您的 iOS 应用程序目标。
  1. 转到
  2. 签名 & 能力 点击.
  3. Section titled “Signing & Capabilities” + 能力 并添加 附近互动.
  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.

Notes

标题为“Notes”的部分
  • getDiscoveryToken() 和 startPeerSession() 仅限 iOS 的 API。
  • 在支持设备的 iOS 16+ 上可用，提供相机辅助功能。