Avvio rapido

Installazione

Puoi utilizzare la nostra configurazione assistita dall'IA per installare il plugin. Aggiungi le Capgo competenze al tuo strumento di AI utilizzando il seguente comando:

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

Poi utilizza la seguente richiesta:

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

Se preferisci l'installazione manuale, installa il plugin eseguendo i seguenti comandi e segui le istruzioni specifiche per la piattaforma riportate di seguito.

bun add @capgo/capacitor-uwb
bunx cap sync

Importa

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

Verifica la disponibilità

const availability = await CapacitorUwb.isAvailable();

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

Sessione peer iOS

1. Chiamata getDiscoveryToken() su entrambi i dispositivi.
2. Scambiare i token base64 restituiti fuori banda.
3. Avvia la scansione con il token peer.

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

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

Vedi iOS setup per le richieste di capacità e autorizzazioni.

Sessione del Controller Android / Controlee

1. Il controller chiama startControllerSession() e condivide i token restituiti rangingParameters e localAddress.
2. Il controlee costruisce il proprio rangingParameters, utilizzando il controller localAddress come peerAddress.
3. Il controllore chiama startControleeSession({ rangingParameters }).
4. Passare optionalmente peerAddress al controller una volta conosciuto l'indirizzo del controllore.

const controller = await CapacitorUwb.startControllerSession();

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

Vedi Impostazione Android per le richieste di hardware e le autorizzazioni.

Ascolta Aggiornamenti

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

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

Interrompi La Sessione

await CapacitorUwb.stopSession();

Fonte Di Verità

Questa pagina è generata dal plugin’s src/definitions.ts. Aggiorna le definizioni TypeScript e esegui bun run docgen in repository del plugin per rinfrescare i API documenti generati.