내용으로 건너뛰기

iOS 설정

GitHub

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

iOS 네이티브 시스템 사용

iOS에서 이 플러그인은 근접 상호작용 framework에서 NearbyInteraction 필수 조건

필수 조건

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

Xcode 설정

Xcode 설정
  1. Xcode에서 iOS 앱 목표를 열어주세요.
  2. 가장 인증 및 기능.
  3. 클릭 + 기능 그리고 근접 상호 작용.
  4. 근접 상호 작용 사용 설명을 추가해주세요. Info.plist:
<key>NSNearbyInteractionUsageDescription</key>
<string>This app uses Ultra Wideband to measure distance to nearby devices.</string>

클라이언트 흐름

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

각 기기의 discoveryToken 자신의 전송 계층을 사용하여 다른 peer와 공유합니다. 플러그인은 자동으로 검색 또는 네트워킹을 수행하지 않습니다.

이벤트

이벤트
  • rangingUpdate 거리 및 방향 업데이트와 같은 정보를 제공합니다.
  • sessionStateChanged 생명주기 상태 running, suspended, invalidated, peerDisconnected.

Notes

Notes
  • getDiscoveryToken() 그리고 startPeerSession() {"targetLanguage":"Korean","pagePath":"/ko/docs/plugins/uwb/ios/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"iOS 전용 API입니다."},{"text":"iOS 16 이상에서 지원하는 장치에 따라 카메라 지원이 가능합니다."},{"text":"페이지 편집"}]}
  • __CAPGO_KEEP_0__