メインコンテンツへスキップ

Android セットアップ

GitHub

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 利用可能な場合、距離と角度の測定値をemitします。
  • sessionStateChanged などのライフサイクル状態をemitします。 running, invalidatedや peerDisconnected.
  • startControllerSession() と startControleeSession() は Android 専用の API です。
  • このプラグインは、測位パラメータの交換に使用する BLE やバックエンドのトランスポートを提供しません。