Configurazione iOS

Sistema nativo iOS utilizzato

Sulla piattaforma 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. Aprite il vostro target di app iOS in Xcode.
2. Vai a Autenticazione e Capacità.
3. Clicca + Capacità e aggiungi Interazione vicina.
4. 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 discoveryToken con l'altro peer utilizzando il tuo layer di trasporto. Il plugin non esegue la scoperta o la rete per conto tuo.

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 fotocamera è disponibile su iOS 16+ quando supportata dal dispositivo.