Setup iOS

Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.

Sistem native iOS yang digunakan

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

Persyaratan

iOS 15+
Perangkat fisik dengan hardware UWB
Fitur Nearby Interaction aktif di Xcode

Setup Xcode

Buka target aplikasi iOS Anda di Xcode.
Buka Signing & Capabilities.
Klik + Capability dan tambahkan Interaksi Terdekat.
Tambahkan deskripsi penggunaan ke Info.plist:

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

Alur Client

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

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

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

Bagikan setiap perangkat discoveryToken ke peer lain menggunakan transport layer Anda sendiri. Plugin ini tidak melakukan discovery atau networking untuk Anda.

Event

rangingUpdate mengirimkan update jarak dan arah saat tersedia.
sessionStateChanged mengirimkan status lifecycle seperti running, suspended, invalidated, dan peerDisconnected.

Catatan

getDiscoveryToken() dan startPeerSession() adalah API khusus iOS.
Bantuan kamera tersedia di iOS 16+ jika didukung perangkat.