スタート

インストール

CapgoのAI-Assisted Setupを使用してプラグインをインストールできます。AIツールにCapgoスキルを追加するには、以下のコマンドを実行してください。

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.

Manual Setupを使用する場合は、以下のコマンドを実行してプラグインをインストールし、以下のプラットフォーム固有の指示に従ってください。

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.');
}

iOS ペア セッション

1. 呼び出し getDiscoveryToken() 両方のデバイスで。
2. Exchange the returned base64 tokens out-of-band.
3. Start ranging with the peer token.

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

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

See iOS setup for capability and permission requirements.

Android Controller / Controlee Session

1. The controller calls startControllerSession() and shares the returned rangingParameters and localAddress.
2. The controlee builds its own rangingParameters, コントローラーを使用します。 localAddress として peerAddress.
3. コントロールされる側がコントローラーに呼び出します。 startControleeSession({ rangingParameters }).
4. コントロールされる側のアドレスがわかったら、コントローラーに渡すことができます。 peerAddress クリップボードにコピー

const controller = await CapacitorUwb.startControllerSession();

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

ハードウェアとパーミッションの要件については、 更新を待つ セクション “更新を待つ”

クリップボードにコピー

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.tsTypeScript定義を更新し、生成されたドキュメントを更新するには、 bun run docgen in the plugin repository to refresh the generated API docs.