안드로이드 설정

안드로이드 네이티브 시스템 사용

안드로이드에서 이 플러그인은 Jetpack UWB from androidx.core.uwb.

Requirements

• Android 12+
• UWB 장치
• 시스템 설정에서 UWB를 활성화합니다.

Manifest 및 권한

The plugin declares:

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

대부분의 앱에서 추가적인 manifest 변경이 필요하지 않습니다.

컨트롤러 흐름

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.

Notes

• startControllerSession() 그리고 startControleeSession() Android만 지원하는 API입니다.
• 플러그인은 BLE 또는 백엔드 전송을 위한 ranging 매개변수를 교환하는 데 사용되는 플러그인이 제공하지 않습니다.