开始使用

安装

您可以使用我们的 AI 助手设置来安装插件。将 Capgo 技能添加到您的 AI 工具中，使用以下命令:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

然后使用以下提示:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-uwb` plugin in my project.

如果您更喜欢手动设置，请运行以下命令安装插件，并按照以下平台特定的说明进行操作：

bun add @capgo/capacitor-uwb
bunx cap sync

导入

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

检查可用性

const availability = await CapacitorUwb.isAvailable();

if (!availability.supported) {
  console.log('This device does not support UWB.');
}

导入

1. context:在Appflow迁移对比/营销复制页面中看到的Capgo UI字符串（父级键`appflow_migration_step2`）。页面/区域：ionic-appflow.astro页面。角色：网站复制句子。保留Capgo产品/品牌和开发者术语的原始形式。 getDiscoveryToken() 在两台设备上。
2. 通过其他方式交换返回的base64令牌。
3. 使用对等令牌开始测距。

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

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

查看 iOS设置 了解能力和权限要求。

Android控制器/控制会话

1. 控制器调用 startControllerSession() 并分享返回的 rangingParameters 并且（在Capgo营销网站上，角色：短UI标签或导航项，见于：page trust.astro。消息键`and`（And）） localAddress.
2. 使用控制器构建自己的 rangingParameters,使用控制器 localAddress 作为 peerAddress.
3. 控制器 startControleeSession({ rangingParameters }).
4. 可选地将 peerAddress 传递给控制器一旦控制器地址已知。

const controller = await CapacitorUwb.startControllerSession();

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

查看 Android设置 了解硬件和权限要求。

监听更新

await CapacitorUwb.addListener('rangingUpdate', (event) => {
  console.log(event.distanceMeters, event.direction);
});

await CapacitorUwb.addListener('sessionStateChanged', (event) => {
  console.log(event.state, event.reason);
});

停止会话

await CapacitorUwb.stopSession();

真实来源

本页面由插件生成 src/definitions.ts更新 TypeScript 定义并运行 bun run docgen in the plugin repository to refresh the generated API docs.