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