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" />

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

コントローラーフロー

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

コントロール アドレス

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

イベント

• rangingUpdate 利用可能な場合に距離と角度測定値を発行します。
• sessionStateChanged 発行されるライフサイクル状態は running, invalidated, そして peerDisconnected.

ノート

• startControllerSession() そして startControleeSession() Android専用APIです。
• プラグインはBLEまたはバックエンドトランスポートを提供せず、測距パラメータの交換に使用します。