Mulai

Instal

Anda dapat menggunakan Pengaturan Bantu AI untuk menginstal plugin. Tambahkan Capgo kemampuan ke alat AI Anda menggunakan perintah berikut:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Lalu gunakan prompt berikut:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-uwb` plugin in my project.

Jika Anda lebih suka Setup Manual, instal plugin dengan menjalankan perintah-perintah berikut dan ikuti instruksi spesifik platform di bawah ini:

bun add @capgo/capacitor-uwb
bunx cap sync

Import

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

Periksa Ketersediaan

const availability = await CapacitorUwb.isAvailable();

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

Sesi Peer iOS

1. Panggilan getDiscoveryToken() di kedua perangkat.
2. Tukarlah token base64 yang dikembalikan secara tidak langsung.
3. Mulai melakukan pencarian dengan token peer.

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

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

Lihat pengaturan iOS untuk persyaratan kemampuan dan izin.

Sesi Pengontrol Android / Kontrolir

1. Pengontrol memanggil startControllerSession() dan berbagi token yang dikembalikan rangingParameters dan localAddress.
2. Membangun Kontrol Kontrol Kontrol sendiri rangingParametersMenggunakan Kontrol Kontrol Kontrol localAddress sebagai peerAddress.
3. Menggunakan Kontrol Kontrol Kontrol startControleeSession({ rangingParameters }).
4. Melewati Optionally ke Kontrol Kontrol Kontrol setelah alamat Kontrol Kontrol Kontrol diketahui. peerAddress Salin ke papan klip

const controller = await CapacitorUwb.startControllerSession();

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

Pengaturan Android untuk persyaratan perangkat keras dan izin. Dengar Perbarui

Bagian berjudul “Dengar Perbarui”

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

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

Hentikan Sesi

await CapacitorUwb.stopSession();

Sumber Kebenaran

Halaman ini dihasilkan dari plugin’s src/definitions.tsPerbarui definisi TypeScript dan jalankan bun run docgen di repository plugin untuk memperbarui dokumen yang dihasilkan API.