본문 바로가기

Android 설정

GitHub

사용되는 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" />

대부분의 앱에서는 매니페스트에 추가적인 변경 사항이 필요하지 않습니다.

컨트롤러 플로우

“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>',
});
await CapacitorUwb.startControleeSession({
rangingParameters: {
sessionId: 12345,
sessionKeyInfo: '<base64>',
complexChannel: { channel: 9, preambleIndex: 10 },
peerAddress: '<controller-address-base64>',
},
});
  • rangingUpdate 사용 가능한 경우 거리와 각도 측정값을 emit합니다.
  • sessionStateChanged 다음과 같은 라이프사이클 상태를 내보냅니다: running, invalidated, 그리고 peerDisconnected.
  • startControllerSession() 및 startControleeSession() Android 전용 API입니다.
  • 이 플러그인은 ranging 파라미터 교환을 위한 BLE 또는 백엔드 전송을 제공하지 않습니다.