Configurazione 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

Configurazione di 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 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 con l'altro peer utilizzando il tuo layer di trasporto. Il plugin non esegue la scoperta o la rete per conto tuo. discoveryToken Eventi

Sottosezione intitolata “Eventi”

rangingUpdate emette stati di ciclo di vita come
sessionStateChanged , e running, suspended, invalidatedNote peerDisconnected.

Sottosezione intitolata “Note”

getDiscoveryToken() sono API iOS esclusive. startPeerSession() e
{"targetLanguage":"Italian","pagePath":"/it/docs/plugins/uwb/ios/","protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"],"items":[{"text":"La assistenza della camera è disponibile su iOS 16+ quando supportata dal dispositivo."},{"text":"Modifica pagina"}]}