始め方

このプラグインのインストールステップとマークダウンガイドの全てを含む設定用の質問をコピーする

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-uwb`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/uwb/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

インストール

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 ペアセッション

コール getDiscoveryToken() 両方のデバイスで。
返されたbase64トークンをオフラインで交換してください。
ペア用トークンで範囲を開始してください。

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

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

参照 iOSの設定機能とパーミッションの要件については

Android Controller / Controlee Session

コントローラーは startControllerSession() 返された rangingParameters そして localAddress.
コントロール対象は自身の rangingParameters, コントローラーを使用して localAddress として peerAddress.
コントロール対象は startControleeSession({ rangingParameters }).
コントローラーに渡すには 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.

始め方