Vai al contenuto

Per iniziare

GitHub

Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:

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

Poi usa il seguente prompt:

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

Se preferisci la configurazione manuale, installa il plugin eseguendo questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:

Finestra del terminale
bun add @capgo/capacitor-barometer
bunx cap sync
import { CapacitorBarometer } from '@capgo/capacitor-barometer';
import { CapacitorBarometer } from '@capgo/capacitor-barometer';
await CapacitorBarometer.startMeasurementUpdates();
await CapacitorBarometer.addListener('measurement', (event) => {
console.log('hPa', event.pressure);
});

Chiama startMeasurementUpdates() prima. getMeasurement() restituisce 0 finché non arriva il primo evento del sensore.

  • Web: da considerare non disponibile, isAvailable() è false.
  • Altitudine relativa iOS: only meaningful while updates run.
  • Batteria: chiamata stopMeasurementUpdates() al termine.

Ottieni la lettura più recente del barometro rilevata dal layer nativo.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';
const result = await CapacitorBarometer.getMeasurement();
console.log(result);

Verifica se il dispositivo corrente ha un sensore barometrico.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';
const result = await CapacitorBarometer.isAvailable();
console.log(result);

Avvia lo streaming degli aggiornamenti del barometro al layer JavaScript.

Chiama addListener con il measurement evento per ricevere gli aggiornamenti.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';
await CapacitorBarometer.startMeasurementUpdates();

Interrompi gli aggiornamenti continui avviati tramite startMeasurementUpdates.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';
await CapacitorBarometer.stopMeasurementUpdates();

Restituisce lo stato attuale dei permessi per accedere ai dati del barometro.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';
const result = await CapacitorBarometer.checkPermissions();
console.log(result);

Richiede il permesso per accedere ai dati del barometro, se richiesto dalla piattaforma.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';
const result = await CapacitorBarometer.requestPermissions();
console.log(result);

Alias per l'ultimo campione di pressione rilevato.

export type GetMeasurementResult = Measurement;

Risultato restituito da isAvailable.

export interface IsAvailableResult {
/**
* Indicates whether the device exposes a barometer sensor.
*
* @since 1.0.0
*/
isAvailable: boolean;
}

Informazioni sui permessi restituite da checkPermissions e requestPermissions.

export interface PermissionStatus {
/**
* The permission state for accessing barometer measurements on the current platform.
*
* @since 1.0.0
*/
barometer: BarometerPermissionState;
}

Payload dell'evento emesso quando startMeasurementUpdates è attivo.

export type MeasurementEvent = Measurement;

Valori di pressione atmosferica e altitudine relativa campionati dal barometro del dispositivo.

export interface Measurement {
/**
* The static air pressure in hectopascals (hPa).
*
* @since 1.0.0
*/
pressure: number;
/**
* The change in altitude relative to the time updates started.
* Only available on iOS; Android will always return `0`.
*
* @since 1.0.0
*/
relativeAltitude: number;
/**
* The timestamp of the measurement in milliseconds since the Unix epoch.
*
* @since 1.0.0
*/
timestamp: number;
}

Unione di stati di autorizzazione che include limited per le piattaforme che possono limitare l'accesso ai sensori.

export type BarometerPermissionState = PermissionState | 'limited';

Stati dei permessi della piattaforma supportati da Capacitor.

export type PermissionState = 'prompt' | 'prompt-with-rationale' | 'granted' | 'denied';

Questa pagina è generata dal src/definitions.ts. Riesegui la sync quando il API pubblico cambia upstream.

Se stai usando Per iniziare per pianificare le operazioni della dashboard e di API, collegalo a Utilizzo di @capgo/capacitor-barometer per la funzionalità nativa in Using @capgo/capacitor-barometer, Panoramica API per i dettagli di implementazione in Panoramica di API, Introduzione per i dettagli di implementazione in Introduzione, Chiavi API per i dettagli di implementazione in Chiavi API, e Dispositivi per i dettagli di implementazione in Dispositivi.