Pengaturan iOS

Copas prompt pengaturan dengan langkah instalasi dan panduan markdown lengkap untuk plugin ini.

Sistem iOS native yang digunakan

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

Persyaratan

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

Pengaturan Xcode

Buka target aplikasi iOS Anda di Xcode.
Pergi ke Tanda Tangan & Kemampuan.
Klik + Kemampuan dan tambahkan Interaksi Lokal.
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 setiap perangkat discoveryToken Menggunakan transport layer milik Anda untuk berkomunikasi dengan peer lainnya. Plugin ini tidak melakukan penemuan atau pengaturan jaringan untuk Anda.

Events

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

Notes

getDiscoveryToken() and startPeerSession() Hanya tersedia untuk API iOS.
Bantuan kamera tersedia pada iOS 16+ ketika didukung oleh perangkat.