안드로이드 설정

설치

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

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

요구 사항

안드로이드 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>',
});

__CAPGO_KEEP_0__

await CapacitorUwb.startControleeSession({
  rangingParameters: {
    sessionId: 12345,
    sessionKeyInfo: '<base64>',
    complexChannel: { channel: 9, preambleIndex: 10 },
    peerAddress: '<controller-address-base64>',
  },
});

이벤트

rangingUpdate 측정 가능한 경우 거리 및 각도 측정치를 내보냅니다.
sessionStateChanged 생명주기 상태 running, invalidated, peerDisconnected.

메모

startControllerSession() Android 전용 API만 제공합니다. startControleeSession() BLE 또는 백엔드 전송을 제공하지 않습니다.
The plugin does not provide BLE or backend transport for exchanging ranging parameters.