Android 설정

사용 중인 Android 네이티브 시스템

Android에서 이 플러그인은 다음을 사용합니다 Jetpack UWB from 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 측정 가능한 거리와 각도 데이터를 방출합니다.
• sessionStateChanged 다음과 같은 라이프사이클 상태를 방출합니다: running, invalidated, 그리고 peerDisconnected.

참고 사항

• startControllerSession() 및 startControleeSession() Android 전용 API입니다.
• 이 플러그인은 ranging 파라미터 교환을 위한 BLE 또는 백엔드 전송 기능을 제공하지 않습니다.