Configuration iOS

Système natif iOS utilisé

Sur iOS, ce plugin utilise Interaction proche à partir du NearbyInteraction framework.

Exigences

• iOS 15+
• Appareil physique avec matériel UWB
• Capacité d'interaction proche activée dans Xcode

Configuration Xcode

1. Ouvrez votre cible d'application iOS dans Xcode.
2. Allez à Signature et capacités.
3. Cliquez + Capacité et ajoutez Interaction à proximité.
4. Ajoutez une description d'utilisation à Info.plist:

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

Flux du client

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

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

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

Partagez chaque appareil's discoveryToken Utilisez votre propre couche de transport avec l'autre pair. Ce plugin ne réalise pas la découverte ou le réseau pour vous.

Événements

• rangingUpdate émet des mises à jour de distance et de direction lorsque disponibles.
• sessionStateChanged émet des états de cycle de vie comme running, suspended, invalidated, et peerDisconnected.

Notes

• getDiscoveryToken() et startPeerSession() sont des API iOS uniquement.
• L'aide de la caméra est disponible sur iOS 16+ lorsque le dispositif le supporte.