Pengaturan iOS

Sistem iOS native digunakan

Pada iOS, plugin ini menggunakan Interaksi Lokal dari NearbyInteraction framework.

Persyaratan

• iOS 15+
• Perangkat fisik dengan perangkat keras UWB
• Kemampuan Interaksi Lokal diaktifkan di Xcode

Konfigurasi Xcode

1. Buka target aplikasi iOS Anda di Xcode.
2. Pergi ke Tanda Tangan & Kemampuan.
3. Klik + Kemampuan dan tambahkan Interaksi Lokal.
4. Tambahkan deskripsi penggunaan ke Info.plist:

<key>NSNearbyInteractionUsageDescription</key>
<string>This app uses Ultra Wideband to measure distance to nearby devices.</string>

Alur Klien

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

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

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

Bagikan perangkat masing-masing discoveryToken dengan peer lain menggunakan lapisan transportasi sendiri. Plugin ini tidak melakukan penemuan atau jaringan untuk Anda.

Event

• rangingUpdate mengeluarkan pembaruan jarak dan arah ketika tersedia.
• sessionStateChanged mengeluarkan status siklus hidup seperti running, suspended, invalidated, dan peerDisconnected.

Catatan

• getDiscoveryToken() dan startPeerSession() hanya tersedia API iOS.
• Bantuan kamera tersedia di iOS 16+ ketika didukung oleh perangkat.