Setup iOS

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

Sistema nativo iOS utilizzato

Su iOS, questo plugin utilizza Interazione ravvicinata presente nella NearbyInteraction framework.

Requisiti

iOS 15+
Dispositivo fisico con hardware UWB
Capability Nearby Interaction abilitata in Xcode

Xcode setup

Apri il target della tua app iOS in Xcode.
Vai su Firma e Capabilities.
Clicca su + Funzionalità e aggiungi Interazione ravvicinata.
Aggiungi una descrizione d'uso a Info.plist:

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

Flusso client

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

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

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

Condividi i dati di ogni dispositivo discoveryToken con l'altro peer tramite il tuo layer di trasporto. Il plugin non gestisce la discovery o il networking.

Eventi

rangingUpdate emette aggiornamenti di distanza e direzione quando disponibili.
sessionStateChanged emette gli stati del ciclo di vita come running, suspended, invalidated, e peerDisconnected.

Note

getDiscoveryToken() e startPeerSession() sono API solo per iOS.
L'assistenza della fotocamera è disponibile su iOS 16+ se supportata dal dispositivo.