跳转至正文
@capgo/capacitor-uwb 设备 API 开源

UWB Capacitor 插件

基于 iOS Nearby Interaction 与 Android Jetpack UWB 的超宽带测距,可获取设备间距离和方向

安装

bun add @capgo/capacitor-uwb bunx cap sync
npm、pnpm 或 yarn
  • npm install @capgo/capacitor-uwb
  • pnpm add @capgo/capacitor-uwb
  • yarn add @capgo/capacitor-uwb

指南

如何在 Capacitor 中使用 UWB

在设备上测试

下载 Capgo App,然后扫描二维码 code。

UWB 插件预览二维码 code

使用 @capgo/capacitor-uwb

用于 iOS 和 Android 超宽带 (UWB) 测距的 Capacitor 插件。

安装

bun add @capgo/capacitor-uwb
bunx cap sync

插件暴露的内容

  • isAvailable - 检查是否支持 UWB 以及当前是否可用。
  • getDiscoveryToken - 在 iOS 上获取本地 Nearby Interaction discovery token。
  • startPeerSession - 启动 iOS peer ranging 会话。
  • startControllerSession - 启动 Android 控制端会话并返回可共享的参数。
  • startControleeSession - 根据控制端参数启动 Android 被控端会话。
  • stopSession - 停止当前正在进行的测距会话。

用法示例

检查可用性

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

const availability = await CapacitorUwb.isAvailable();

iOS 对等测距

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

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

Android 控制器 / 受控器

const controller = await CapacitorUwb.startControllerSession();

await CapacitorUwb.startControleeSession({
  rangingParameters: controller.rangingParameters,
});

完整参考

继续阅读:使用 @capgo/capacitor-uwb

如果你正在使用 使用 @capgo/capacitor-uwb 要规划原生插件工作,请将其与 @capgo/capacitor-uwb 了解 @capgo/capacitor-uwb 中的实现细节, 快速入门 有关“入门指南”中的实现细节, Capgo 插件目录 查看 Capgo 插件目录中的产品工作流, Capgo 提供的 Capacitor 插件 有关 Capgo 开发的 Capacitor 插件的实现细节,以及 添加或更新插件 有关添加或更新插件的实现细节。

常见问题

UWB 插件常见问题

如何在 Capacitor 应用中安装 UWB 插件?

运行 "bun add @capgo/capacitor-uwb"(或 "npm install @capgo/capacitor-uwb"),然后运行 "bunx cap sync",以便 iOS 和 Android 项目获取原生 code。在您的应用 code 中从 "@capgo/capacitor-uwb" 导入它。

@capgo/capacitor-uwb 支持 React、Vue 和 Angular 吗?

是的。UWB 是一个 Capacitor 包,因此它适用于任何在 Capacitor 内运行的 Web 框架,包括 Ionic、React、Vue、Angular、Svelte 和纯 JavaScript。

@capgo/capacitor-uwb 支持哪个版本的 Capacitor?

Capgo 插件遵循 Capacitor 的主版本号:请使用与 Capacitor 主版本号一致的插件主版本(例如插件 v8 对应 Capacitor 8)。GitHub README 中的兼容性表列出了仍在维护的版本。

@capgo/capacitor-uwb 是免费且开源的吗?

是的。源代码 code 在 GitHub 上公开,地址为 https://github.com/Cap-go/capacitor-uwb/,并且可以从 npm 免费安装该包。欢迎提交 Bug 报告和 Pull Request。

我可以更新使用 UWB 的 code 而无需经过 App Store 审核吗?

安装或升级插件会改动原生 code,因此需要重新做一次商店构建。之后,调用该插件的 JavaScript、HTML 和 CSS 改动就能通过 Capgo live updates 立即发布。

无需等待应用审核即可发布 UWB 变更

只要插件已包含在你的商店版本中,Capgo live updates 就能在几分钟内把 JavaScript、HTML 和 CSS 的改动推送给用户。

开始使用 Capgo