시작하기

설치

플러그인을 설치하기 위해 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() both devices.
2. out-of-band으로 base64 토큰을 교환하십시오.
3. peer 토큰으로 ranging을 시작하십시오.

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.