iOS 설정

iOS에서 사용되는 네이티브 시스템

Nearby Interaction Nearby Interaction from the NearbyInteraction 프레임워크.

요구 사항

• iOS 15+
• UWB 하드웨어를 갖춘 물리적 장치
• Xcode에서 근접 상호 작용 기능이 활성화된 경우

Xcode 설정

1. 다음으로 이동
2. 인증 및 기능 클릭.
3. Section titled “Xcode setup” + 기능 그리고 추가 근접 상호 작용.
4. 사용 설명을 추가하세요 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 자신의 전송 계층을 사용하여 다른 피어와 공유하세요. 플러그인은 발견이나 네트워킹을 수행하지 않습니다.

이벤트

• rangingUpdate 거리와 방향 업데이트이 있을 때 사용 가능한 경우 distance 및 방향 업데이트이 발생합니다.
• sessionStateChanged 생명주기 상태와 같은 running, suspended, invalidated, peerDisconnected.

Notes

• getDiscoveryToken() 및 startPeerSession() iOS 전용 API입니다.
• iOS 16+에서 지원하는 장치에 따라 카메라 지원이 있습니다.