Per iniziare
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-barometer`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/barometer/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
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:
npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsPoi 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:
bun add @capgo/capacitor-barometerbunx cap syncImporta
Sezione intitolata “Import”import { CapacitorBarometer } from '@capgo/capacitor-barometer';Avvio rapido
Sezione intitolata “Quick start”import { CapacitorBarometer } from '@capgo/capacitor-barometer';
await CapacitorBarometer.startMeasurementUpdates();await CapacitorBarometer.addListener('measurement', (event) => { console.log('hPa', event.pressure);});Esempio: singola lettura
Sezione intitolata “Esempio: singola lettura”Chiama startMeasurementUpdates() prima. getMeasurement() restituisce 0 finché non arriva il primo evento del sensore.
Errori comuni
Sezione intitolata “Errori comuni”- Web: da considerare non disponibile,
isAvailable()è false. - Altitudine relativa iOS: only meaningful while updates run.
- Batteria: chiamata
stopMeasurementUpdates()al termine.
Panoramica API
Sezione intitolata “Panoramica API”getMeasurement
Sezione intitolata “getMeasurement”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);isAvailable
Sezione intitolata “isAvailable”Verifica se il dispositivo corrente ha un sensore barometrico.
import { CapacitorBarometer } from '@capgo/capacitor-barometer';
const result = await CapacitorBarometer.isAvailable();console.log(result);startMeasurementUpdates
Sezione intitolata “startMeasurementUpdates”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();stopMeasurementUpdates
Sezione intitolata “stopMeasurementUpdates”Interrompi gli aggiornamenti continui avviati tramite startMeasurementUpdates.
import { CapacitorBarometer } from '@capgo/capacitor-barometer';
await CapacitorBarometer.stopMeasurementUpdates();checkPermissions
Sezione intitolata “checkPermissions”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);requestPermissions
Sezione intitolata “requestPermissions”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);Riferimento ai tipi
Sezione: “Type Reference”GetMeasurementResult
Sezione intitolata “GetMeasurementResult”Alias per l'ultimo campione di pressione rilevato.
export type GetMeasurementResult = Measurement;IsAvailableResult
Sezione intitolata “IsAvailableResult”Risultato restituito da isAvailable.
export interface IsAvailableResult { /** * Indicates whether the device exposes a barometer sensor. * * @since 1.0.0 */ isAvailable: boolean;}PermissionStatus
Sezione intitolata “PermissionStatus”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;}MeasurementEvent
Sezione intitolata “MeasurementEvent”Payload dell'evento emesso quando startMeasurementUpdates è attivo.
export type MeasurementEvent = Measurement;Measurement
Sezione intitolata “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;}BarometerPermissionState
Sezione intitolata “BarometerPermissionState”Unione di stati di autorizzazione che include limited per le piattaforme che possono limitare l'accesso ai sensori.
export type BarometerPermissionState = PermissionState | 'limited';PermissionState
Sezione intitolata “PermissionState”Stati dei permessi della piattaforma supportati da Capacitor.
export type PermissionState = 'prompt' | 'prompt-with-rationale' | 'granted' | 'denied';Fonte di verità
Sezione intitolata “Fonte di verità”Questa pagina è generata dal src/definitions.ts. Riesegui la sync quando il API pubblico cambia upstream.
Continua da Getting Started
Sezione intitolata “Continua da Getting Started”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.