Configuración inicial

Instalar

Puedes utilizar nuestra configuración asistida por IA para instalar el plugin. Agrega las Capgo habilidades a tu herramienta de IA utilizando el siguiente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Usa luego la siguiente solicitud:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-uwb` plugin in my project.

Si prefieres la configuración manual, instala el complemento ejecutando los siguientes comandos y sigue las instrucciones específicas de la plataforma a continuación:

bun add @capgo/capacitor-uwb
bunx cap sync

Importar

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

Verificar disponibilidad

const availability = await CapacitorUwb.isAvailable();

if (!availability.supported) {
  console.log('This device does not support UWB.');
}

Sesión de Pares de iOS

1. Llamar getDiscoveryToken() en ambos dispositivos.
2. Intercambiar los tokens base64 devueltos fuera de banda.
3. Iniciar la medición con el token de pares.

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

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

Ver iOS setup para requisitos de capacidad y permiso.

Sesión de Controlador / Controlado de Android

1. El controlador llama startControllerSession() y comparte el valor devuelto rangingParameters y localAddress.
2. El controlado construye su propio rangingParametersEl controlado construye su propio localAddress as peerAddress.
3. El controlador llama startControleeSession({ rangingParameters }).
4. El controlado llama peerAddress Una vez conocida la dirección del controlado.

const controller = await CapacitorUwb.startControllerSession();

await CapacitorUwb.startControleeSession({
  rangingParameters: {
    ...controller.rangingParameters,
    peerAddress: controller.localAddress,
  },
});

See Configuración de Android para requisitos de hardware y permisos.

Escuchar Actualizaciones

await CapacitorUwb.addListener('rangingUpdate', (event) => {
  console.log(event.distanceMeters, event.direction);
});

await CapacitorUwb.addListener('sessionStateChanged', (event) => {
  console.log(event.state, event.reason);
});

Detener La Sesión

await CapacitorUwb.stopSession();

Fuente De Verdad

Esta página se genera desde el plugin’s src/definitions.ts. Actualice las definiciones de TypeScript y ejecute bun run docgen en el repositorio de plugins para refrescar los documentos generados API.