시작하기

설치

플러그인을 설치하기 위해 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.

만약 Manual Setup을 선호한다면, 플러그인을 설치하기 위해 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:

bun add @capgo/capacitor-uwb
bunx cap sync

수입

import { CapacitorUwb } from '@capgo/capacitor-uwb';

사용 가능 여부 확인

const availability = await CapacitorUwb.isAvailable();

if (!availability.supported) {
  console.log('This device does not support UWB.');
}

iOS 페어 세션

1. 호출 getDiscoveryToken() 두 기기 모두에서.
2. 바이트를 교환하여 밖에서 base64 토큰을 교환하세요.
3. peer 토큰으로 시작하여 범위 설정하세요.

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

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

보기 iOS 설정 능력과 권한 요구 사항을 참조하세요.

안드로이드 컨트롤러 / 컨트롤리 세션

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타입스크립트 정의를 업데이트하고 플러그인 저장소에서 bun run docgen 플러그인 저장소에서 갱신된 API 문서를 새로 생성하기 위해 갱신합니다.