Androidセットアップ

Android のネイティブシステムを使用

Android の場合、このプラグインは Jetpack UWB から androidx.core.uwb.

要件

• Android 12以上
• UWBハードウェア搭載のデバイス
• システム設定でUWBを有効にします

マニフェストとパーミッション

プラグインは以下を宣言します:

<uses-permission android:name="android.permission.UWB_RANGING" />
<uses-feature android:name="android.hardware.uwb" android:required="false" />

ほとんどのアプリでは追加のマニフェスト変更は必要ありません。

Controller flow

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

const controller = await CapacitorUwb.startControllerSession();

// Share controller.rangingParameters and controller.localAddress out-of-band

コントローラー セッションを開始する際に、既知のコントロール アドレスを渡します。

await CapacitorUwb.startControllerSession({
  peerAddress: '<controlee-address-base64>',
});

Controlee flow

await CapacitorUwb.startControleeSession({
  rangingParameters: {
    sessionId: 12345,
    sessionKeyInfo: '<base64>',
    complexChannel: { channel: 9, preambleIndex: 10 },
    peerAddress: '<controller-address-base64>',
  },
});

イベント

• rangingUpdate 距離と角度測定値を発行します。ライフサイクル状態も発行します。
• sessionStateChanged Copy to clipboard running, invalidated, および peerDisconnected.

Notes

• startControllerSession() であり startControleeSession() AndroidのみのAPIです。
• プラグインは、範囲パラメータを交換するためのBLEまたはバックエンドトランスポートを提供しません。