Configuration iOS

Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.

Système natif iOS utilisé

Sur iOS, ce plugin utilise Nearby Interaction issu de la NearbyInteraction framework.

Prérequis

iOS 15+
Appareil physique avec matériel UWB
Capacité Nearby Interaction activée dans Xcode

Configuration Xcode

Open your iOS app target in Xcode.
Accéder à Signature et capacités.
Cliquez + Capability et ajoutez Nearby Interaction.
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 pair via votre propre couche de transport. Le plugin ne gère ni la découverte ni le réseau pour vous.

Événements

rangingUpdate emits distance and direction updates when available.
sessionStateChanged émet des états de cycle de vie tels que running, suspended, invalidated, et peerDisconnected.

Notes

getDiscoveryToken() et startPeerSession() sont des API iOS uniquement.
L'assistance caméra est disponible sur iOS 16+ lorsque l'appareil la prend en charge.