Configurazione iOS

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

1. Apri il tuo target di app iOS in Xcode.
2. Vai a Firma e Capacità.
3. Clicca e aggiungi Interazione vicina Aggiungi una descrizione di utilizzo.
4. Copia nel portapenne 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'altro peer utilizzando il tuo layer di trasporto. Il plugin non esegue la scoperta o la rete per te.

Eventi

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

Note

• getDiscoveryToken() e startPeerSession() sono API disponibili solo per iOS.
• L'assistenza della camera è disponibile su iOS 16+ quando supportata dal dispositivo.