Impostazione di iOS

Sistema nativo iOS utilizzato

Sul iOS, questo plugin utilizza Interazione vicina da NearbyInteraction framework.

Requisiti

• iOS 15+
• Dispositivo fisico con hardware UWB
• Abilita la capacità di interazione vicina in Xcode

Configurazione di Xcode

1. Vai a
2. Firma e abilitazioni Clicca.
3. __CAPGO_KEEP_0__ + Capacità e aggiungi Interazione vicina.
4. 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 con discoveryToken l'altro peer utilizzando il tuo proprio 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 su iOS.
• La assistenza della fotocamera è disponibile su iOS 16+ quando supportata dal dispositivo.