Configuration iOS

Système natif iOS utilisé

Sur iOS, ce plugin utilise Interaction Proche du NearbyInteraction framework.

Exigences

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

Configuration de Xcode

1. Ouvrez votre cible d'application iOS dans Xcode.
2. Allez à Signature et capacités.
3. Cliquez Ajoutez une capacité et ajoutez Interaction proche.
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 client

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

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

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

Partagez chaque appareil discoveryToken avec l'autre appareil pair en utilisant votre propre couche de transport. Le 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 lorsqu'elles sont disponibles.
• sessionStateChanged émet des états de cycle de vie comme running, suspended, invalidated, et peerDisconnected.

Notes

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