iOS Setup

Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.

Sistema nativo de iOS utilizado

En iOS, este plugin utiliza Interacción cercana del NearbyInteraction framework.

Requisitos

iOS 15+
Dispositivo físico con hardware UWB
Nearby Interaction habilitado en Xcode

Xcode setup

Abre el target de tu app iOS en Xcode.
Ve a Firma y capacidades.
Haz clic + Capability y añade Interacción cercana.
Añade 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,
});

Comparte la de cada dispositivo discoveryToken con el otro peer usando tu propia capa de transporte. El plugin no realiza el discovery ni el networking por ti.

Eventos

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

Notas

getDiscoveryToken() y startPeerSession() son APIs exclusivas de iOS.
La asistencia de cámara está disponible en iOS 16+ si el dispositivo lo permite.