시작하기

설치

플러그인을 설치하기 위해 AI-Assisted Setup을 사용할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요:

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.

만들기 옵션을 선택하면, 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요.

bun add @capgo/capacitor-uwb
bunx cap sync

Import

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

1. 호출하기 getDiscoveryToken() 두 기기 모두에서.
2. 반환된 base64 토큰을 밖에서 교환하십시오.
3. 페어 토큰으로 시작하여 거리 측정하십시오.

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

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

보기 iOS 설정 능력과 권한 요구 사항을 위해

Android Controller / Controlee Session

1. 컨트롤러는 startControllerSession() 반환된 rangingParameters 그리고 localAddress.
2. 제어 대상은 자신의 제어 장치를 구축합니다 rangingParameters, 제어 장치를 사용하여 localAddress 으로 peerAddress.
3. 제어 대상은 제어 장치를 호출합니다 startControleeSession({ rangingParameters }).
4. 제어 대상 주소가 알려지면 제어 장치에 옵션을 전달할 수 있습니다 peerAddress 클립보드에 복사

const controller = await CapacitorUwb.startControllerSession();

await CapacitorUwb.startControleeSession({
  rangingParameters: {
    ...controller.rangingParameters,
    peerAddress: controller.localAddress,
  },
});

Android 설정 하드웨어 및 권한 요구 사항을 참조하십시오 업데이트를 듣기

업데이트를 듣기

await CapacitorUwb.addListener('rangingUpdate', (event) => {
  console.log(event.distanceMeters, event.direction);
});

await CapacitorUwb.addListener('sessionStateChanged', (event) => {
  console.log(event.state, event.reason);
});

세션 중지

await CapacitorUwb.stopSession();

진실의 근원

이 페이지는 플러그인의 src/definitions.ts. TypeScript 정의를 업데이트하고 플러그인 저장소에서 bun run docgen in the plugin repository to refresh the generated API docs.