Pengaturan Android

Menggunakan sistem native Android.

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

Persyaratan

• Android 12+
• Perangkat dengan perangkat keras UWB
• UWB diaktifkan di pengaturan sistem

Manifest dan izin

Plugin ini mengumumkan:

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

Tidak perlu ada perubahan manifest tambahan di aplikasi kebanyakan.

Alur pengontrol

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

const controller = await CapacitorUwb.startControllerSession();

// Share controller.rangingParameters and controller.localAddress out-of-band

Jika Anda sudah tahu alamat kontrolan, masukkan saat memulai sesi pengontrol:

await CapacitorUwb.startControllerSession({
  peerAddress: '<controlee-address-base64>',
});

Alur kontrolan

await CapacitorUwb.startControleeSession({
  rangingParameters: {
    sessionId: 12345,
    sessionKeyInfo: '<base64>',
    complexChannel: { channel: 9, preambleIndex: 10 },
    peerAddress: '<controller-address-base64>',
  },
});

Event

• rangingUpdate mengirimkan pengukuran jarak dan sudut ketika tersedia.
• sessionStateChanged mengirimkan status siklus seperti running, invalidated, dan peerDisconnected.

Catatan

• startControllerSession() dan startControleeSession() context: Halaman/area: Situs web pemasaran Capgo. Peran: Label UI singkat atau item navigasi. Dilihat di: halaman trust.astro. Kunci pesan `dan` (Dan).
• hanya tersedia untuk API Android saja.