Impostazione 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 vicina dal NearbyInteraction framework.

Requisiti

iOS 15+
Dispositivo fisico con hardware UWB
Capacità di interazione vicina abilitata in Xcode

Impostazione Xcode

Apri il tuo target di app iOS in Xcode.
Vai a Sottoscrizione e Capacità.
Clicca + Capacità e aggiungi Interazione vicina.
Aggiungi una descrizione di utilizzo a Info.plist:

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

Flusso del client

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

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

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

Condividi ogni dispositivo discoveryToken con l'altra peer utilizzando il tuo layer di trasporto. Il plugin non esegue la scoperta o la rete per conto tuo.

Events

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

Notes

getDiscoveryToken() and startPeerSession() Sono API disponibili solo per iOS.
La camera assistenza è disponibile su iOS 16+ quando supportata dal dispositivo.