はじめに

インストール

AI-Assisted セットアップを使用してプラグインをインストールできます。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() 返された base64 トークンをオフラインで交換する。
2. ペア トークンでレンジを開始する。
3. クリップボードにコピー

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

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

iOS セットアップ iOS セットアップ __CAPGO_KEEP_0__の機能と許可要件。

Android Controller / Controlee Session

1. コントローラーが呼び出し startControllerSession() と、返された rangingParameters および 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定義を更新し、プラグインリポジトリで生成された__CAPGO_KEEP_0__ドキュメントを更新してください。 bun run docgen in the plugin repository to refresh the generated API docs.