Panduan Memulai

Instal

Anda bisa menggunakan AI-Assisted Setup kami untuk menginstal plugin ini. Tambahkan skill Capgo ke tool AI Anda dengan command berikut:

bunx 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 memilih Manual Setup, instal plugin dengan menjalankan perintah berikut dan ikuti petunjuk khusus platform di bawah ini:

bun add @capgo/capacitor-uwb
bunx cap sync

Impor

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

Mulai cepat

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

const result = await CapacitorUwb.isAvailable();
console.log(result);

Contoh: getDiscoveryToken

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

const result = await CapacitorUwb.getDiscoveryToken();
// The result holds sensitive values: use it without logging it.

Contoh: startPeerSession

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

await CapacitorUwb.startPeerSession({ peerDiscoveryToken: 'peer-discovery-token-123' });

Kesalahan umum

• Listeners: hapus handle saat screen unmount.
• Sinkronisasi Native: jalankan bunx cap sync setelah upgrade plugin.
• Sumber kebenaran tunggal: percayai src/definitions.ts di repo GitHub.

Cek Ketersediaan

const availability = await CapacitorUwb.isAvailable();

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

Sesi Peer iOS

1. Panggil getDiscoveryToken() di kedua perangkat.
2. Tukarkan token base64 yang dikembalikan melalui jalur terpisah.
3. Mulai ranging dengan peer token.

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

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

Lihat Setup iOS untuk persyaratan kapabilitas dan izin.

Kontroler Android / Sesi Kontrol

1. Controller memanggil startControllerSession() dan membagikan hasil rangingParameters dan localAddress.
2. Kontrolee membangun miliknya sendiri rangingParameters, menggunakan controller localAddress sebagai peerAddress.
3. Pihak controlee memanggil startControleeSession({ rangingParameters }).
4. Opsional, kirimkan peerAddress ke controller setelah alamat controlee diketahui.

const controller = await CapacitorUwb.startControllerSession();

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

Lihat Setup Android untuk kebutuhan hardware dan izin.

Dengarkan Update

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

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

Stop Session

await CapacitorUwb.stopSession();

Sumber Kebenaran

Halaman ini dibuat dari plugin src/definitions.ts. Perbarui definisi TypeScript dan jalankan bun run docgen di repositori plugin untuk menyegarkan dokumentasi API yang dihasilkan.