Mulai Berjalan

Instalasi

Anda dapat menggunakan Pengaturan Bantu AI kami 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 Pengaturan 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 Pemirsa iOS

1. Panggil getDiscoveryToken() pada kedua perangkat.
2. Tukarlah token base64 yang dikembalikan secara mandiri.
3. Mulai mengukur 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 / Pengontrolan Android

1. Pengontrol memanggil startControllerSession() dan berbagi hasil yang diterima rangingParameters dan localAddress.
2. Buat Kontroler UWB sendiri rangingParametersPengontrolan membangun sendiri localAddress sebagai peerAddress.
3. Kontroler memanggil startControleeSession({ rangingParameters }).
4. Opsi untuk mengirim peerAddress ke kontroler setelah alamat kontroler diketahui.

const controller = await CapacitorUwb.startControllerSession();

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

Lihat Pengaturan Android untuk persyaratan perangkat keras dan izin.

Tunggu Perbaruan

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 API dokumen yang dihasilkan.