Langsung ke konten

Setup Android

GitHub

Di Android, plugin ini menggunakan Jetpack UWB dari androidx.core.uwb.

  • Android 12+
  • Perangkat dengan hardware UWB
  • UWB aktif di pengaturan sistem

Plugin ini mendeklarasikan:

<uses-permission android:name="android.permission.UWB_RANGING" />
<uses-feature android:name="android.hardware.uwb" android:required="false" />

Sebagian besar aplikasi tidak memerlukan perubahan manifest tambahan.

import { CapacitorUwb } from '@capgo/capacitor-uwb';
const controller = await CapacitorUwb.startControllerSession();
// Share controller.rangingParameters and controller.localAddress out-of-band

Jika Anda sudah mengetahui alamat controlee, masukkan saat memulai sesi controller:

await CapacitorUwb.startControllerSession({
peerAddress: '<controlee-address-base64>',
});
await CapacitorUwb.startControleeSession({
rangingParameters: {
sessionId: 12345,
sessionKeyInfo: '<base64>',
complexChannel: { channel: 9, preambleIndex: 10 },
peerAddress: '<controller-address-base64>',
},
});
  • rangingUpdate mengeluarkan pengukuran jarak dan sudut saat tersedia.
  • sessionStateChanged memancarkan status lifecycle seperti running, invalidated, dan peerDisconnected.
  • startControllerSession() dan startControleeSession() adalah API khusus Android.
  • Plugin ini tidak menyediakan BLE atau transport backend untuk bertukar parameter ranging.