Configuración de iOS

Sistema nativo de iOS utilizado

En iOS, este plugin utiliza Interacción cercana desde el NearbyInteraction marco de referencia.

Requisitos

• iOS 15+
• Dispositivo físico con hardware UWB
• Capacidad de interacción cercana habilitada en Xcode

Configuración de Xcode

1. Abra su objetivo de aplicación iOS en Xcode.
2. Vaya a Identificación y capacidades.
3. Haga clic + Capacidad y agregar Interacción cercana.
4. Agregar una descripción de uso a Info.plist:

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

Flujo del cliente

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

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

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

Compartir cada dispositivo con discoveryToken el otro peer utilizando tu propio nivel de transporte. El plugin no realiza la búsqueda o la red para ti.

Eventos

• rangingUpdate emite actualizaciones de distancia y dirección cuando estén disponibles.
• sessionStateChanged emite estados de ciclo de vida tales como running, suspended, invalidated, y peerDisconnected.

Notas

• getDiscoveryToken() y startPeerSession() son APIs solo para iOS.
• La asistencia de cámara está disponible en iOS 16+ cuando esté soportada por el dispositivo.