iOS 설정

이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.

사용된 iOS 네이티브 시스템

iOS에서 이 플러그인은 다음을 사용합니다: Nearby Interaction 에서 NearbyInteraction framework입니다.

요구 사항

iOS 15+
UWB 하드웨어가 탑재된 실제 기기
Xcode에서 Nearby Interaction 기능 활성화

Xcode 설정

Xcode에서 iOS 앱 타겟을 엽니다.
다음으로 이동: Signing & Capabilities.
클릭 + Capability 그리고 추가 Nearby Interaction.
사용 설명(usage description)을 추가하세요: Info.plist:

<key>NSNearbyInteractionUsageDescription</key>
<string>This app uses Ultra Wideband to measure distance to nearby devices.</string>

클라이언트 흐름

import { CapacitorUwb } from '@capgo/capacitor-uwb';

const { discoveryToken } = await CapacitorUwb.getDiscoveryToken();

await CapacitorUwb.startPeerSession({
  peerDiscoveryToken: '<peer-token-base64>',
  isCameraAssistanceEnabled: false,
});

각 디바이스의 정보를 discoveryToken 사용자 정의 transport layer를 통해 상대방과 공유하세요. 이 플러그인은 디스커버리나 네트워킹 기능을 직접 수행하지 않습니다.

이벤트

rangingUpdate 가능한 경우 거리와 방향 업데이트를 내보냅니다.
sessionStateChanged 다음과 같은 라이프사이클 상태를 내보냅니다: running, suspended, invalidated, 그리고 peerDisconnected.

참고 사항

getDiscoveryToken() 및 startPeerSession() iOS 전용 API입니다.
기기에서 지원하는 경우 iOS 16 이상에서 카메라 어시스트를 사용할 수 있습니다.