Android の設定

使用されるAndroidネイティブシステム

Androidでは、このプラグインは以下を使用します： Jetpack UWB と androidx.core.uwb.

前提条件

• Android 12以降
• UWBハードウェア搭載デバイス
• システム設定でUWBが有効であること

Manifestと権限

プラグインが宣言する内容：

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

ほとんどのアプリでは、追加のmanifest変更は不要です。

Controllerのフロー

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

const controller = await CapacitorUwb.startControllerSession();

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

すでにcontroleeのアドレスがわかっている場合は、controllerセッションの開始時に渡してください：

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

Controleeのフロー

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

イベント

• rangingUpdate 利用可能なときに、距離と角度の測定値をemitします。
• sessionStateChanged 以下のようなライフサイクル状態をエミットします： running, invalidated、および peerDisconnected.

備考

• startControllerSession() と startControleeSession() はAndroid専用のAPIです。
• このプラグインは、レンジングパラメータの交換のためのBLEやバックエンド転送は提供していません。