내용으로 건너뛰기

iOS 설정

GitHub

iOS 원시 시스템 사용

iOS 네이티브 시스템 사용

iOS에서 이 플러그인은 근접 상호작용 from the NearbyInteraction 프레임워크에서

framework.

요구 사항
  • iOS 15+
  • UWB 하드웨어가 장착된 물리적 장치
  • Xcode에서 근접 상호작용 기능이 활성화됨

Xcode 설정

Xcode setup
  1. iOS 앱 대상 열기.
  2. 로 이동하세요. 인증 및 기능.
  3. 클릭 기능 추가 근접 상호 작용 사용 설명 추가.
  4. 클립보드 복사 Info.plist:
<key>NSNearbyInteractionUsageDescription</key>
<string>This app uses Ultra Wideband to measure distance to nearby devices.</string>

Client flow 섹션

Nearby Interaction
import { CapacitorUwb } from '@capgo/capacitor-uwb';
const { discoveryToken } = await CapacitorUwb.getDiscoveryToken();
await CapacitorUwb.startPeerSession({
peerDiscoveryToken: '<peer-token-base64>',
isCameraAssistanceEnabled: false,
});

장치당 discoveryToken 다른 피어와 공유하기 위해

  • rangingUpdate 이벤트
  • sessionStateChanged 이벤트 running, suspended, invalidated거리 및 방향 업데이트 peerDisconnected.

생명주기 상태

생명주기 상태
  • getDiscoveryToken() 준비 startPeerSession() 실행
  • 중지