Pengaturan iOS

Sistem native iOS digunakan

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

Persyaratan

• iOS 15+
• Perangkat fisik dengan perangkat keras UWB
• Fungsi Interaksi Dekat diaktifkan di Xcode

Pengaturan Xcode

1. Pergi ke
2. Tanda Tangan & Kemampuan Klik.
3. Section titled “Signing & Capabilities” + 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 setiap discoveryToken dengan peer lain menggunakan lapisan transportasi Anda sendiri. Plugin ini tidak melakukan penemuan atau jaringan untuk Anda.

Event

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

Catatan

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