시작하기
__CAPGO_KEEP_4__
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-uwb`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/uwb/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
__CAPGO_KEEP_11__
설치란 제목Capgo AI 도구에 다음 명령어를 사용하여 플러그인을 설치할 수 있습니다.
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins그다음 다음 프롬프트를 사용하세요.
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-uwb` plugin in my project.만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래에 플랫폼에 따라 설명된 지침을 따르세요.
bun add @capgo/capacitor-uwbbunx cap syncImport
임포트란 제목import { CapacitorUwb } from '@capgo/capacitor-uwb';사용 가능 여부 확인
사용 가능 여부 확인 섹션const availability = await CapacitorUwb.isAvailable();
if (!availability.supported) { console.log('This device does not support UWB.');}iOS Peer Session
iOS Peer Session 섹션- 전화
getDiscoveryToken()두 기기 모두에서. - 반대 방향으로 반환 된 base64 토큰을 교환하십시오.
- 페어 토큰으로 페어링을 시작하십시오.
const { discoveryToken } = await CapacitorUwb.getDiscoveryToken();
await CapacitorUwb.startPeerSession({ peerDiscoveryToken: '<peer-token-base64>',});iOS 설정 보기 iOS 설정 __CAPGO_KEEP_0__.
안드로이드 컨트롤러 / 컨트롤리 세션
‘안드로이드 컨트롤러 / 컨트롤리 세션’ 제목- 컨트롤러가 호출합니다.
startControllerSession()그것을 반환하고rangingParameters그것을localAddress. - 컨트롤리 자신이
rangingParameters컨트롤러를 사용하여localAddress컨트롤리 자신이 호출합니다.peerAddress. - 컨트롤러에 알려지면 옵션으로
startControleeSession({ rangingParameters }). - 컨트롤리 주소가 알려지면 컨트롤러에 한번에 전달할 수 있습니다.
peerAddress컨트롤리 주소가 알려지면 컨트롤러에 한번에 전달할 수 있습니다.
const controller = await CapacitorUwb.startControllerSession();
await CapacitorUwb.startControleeSession({ rangingParameters: { ...controller.rangingParameters, peerAddress: controller.localAddress, },});See Android 설정 하드웨어 및 권한 요구 사항에 대해.
업데이트를 듣기
Listen For Updatesawait CapacitorUwb.addListener('rangingUpdate', (event) => { console.log(event.distanceMeters, event.direction);});
await CapacitorUwb.addListener('sessionStateChanged', (event) => { console.log(event.state, event.reason);});세션을 중지
Stop The Sessionawait CapacitorUwb.stopSession();이 페이지는 플러그인의 src/definitions.ts. TypeScript 정의를 업데이트하고 생성된 __CAPGO_KEEP_0__ 문서를 갱신하기 위해 플러그인 저장소에서 bun run docgen in the plugin repository to refresh the generated API docs.