Empezar

Instalación

Puede utilizar nuestra configuración asistida por IA para instalar el complemento. Agregue las Capgo habilidades a su herramienta de IA utilizando el siguiente comando:

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

Luego utilice el siguiente prompt:

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

Si prefiere la configuración manual, instale el complemento ejecutando los siguientes comandos y siguiendo 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';

Ver 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() contexto: HTML fragmento de texto de una cadena de Capgo UI más larga (clave de página `appflow_migration_step2`). Página/área: Comparación y migración de Appflow. Rol: Copia de sitio web. Visto en: página ionic-appflow.astro. Mantener términos de producto/marca y desarrollador de Capgo exactamente. Clave de mensaje `appflow_migration_step2` (Paso 2 de migración de Appflow). Llamar a ambos dispositivos.
2. Intercambie los tokens base64 devueltos fuera de banda.
3. Inicie la medición con el token de la pareja.

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

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

Ver Configuración de iOS para requisitos de capacidad y permisos.

Sesión del controlador / controlado Android

1. El controlador llama startControllerSession() y comparte los devueltos rangingParameters y localAddress.
2. El controlado construye su propio rangingParameters, utilizando el controlador localAddress como peerAddress.
3. El controlador llama startControleeSession({ rangingParameters }).
4. Opcionalmente pasar peerAddress al controlador una vez que se conoce la dirección del controlado.

const controller = await CapacitorUwb.startControllerSession();

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

Ver 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 a partir del plugin’s src/definitions.ts. Actualice las definiciones de TypeScript y ejecute bun run docgen in el repositorio del plugin para refrescar los documentos generados API.