Erste Schritte

Installieren

Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge deinem KI-Tool die Capgo Skills mit folgendem Befehl hinzu:

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

Nutze anschließend diesen Prompt:

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

Wenn du ein manuelles Setup bevorziehst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

bun add @capgo/capacitor-barometer
bunx cap sync

Importieren

import { CapacitorBarometer } from '@capgo/capacitor-barometer';

Quickstart

import { CapacitorBarometer } from '@capgo/capacitor-barometer';

await CapacitorBarometer.startMeasurementUpdates();
await CapacitorBarometer.addListener('measurement', (event) => {
  console.log('hPa', event.pressure);
});

Beispiel: Einzelmessung

Rufe startMeasurementUpdates() Zuerst. getMeasurement() gibt zurück 0 bis das erste Sensor-Event eintrifft.

Häufige Fehlerquellen

• Web: als nicht verfügbar behandeln, isAvailable() ist false.
• iOS relative Höhe: nur während Updates sinnvoll.
• Akku: Aufruf stopMeasurementUpdates() wenn fertig.

API Übersicht

getMeasurement

Ruft den aktuellsten Barometerwert ab, der vom Native Layer erfasst wurde.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';

const result = await CapacitorBarometer.getMeasurement();
console.log(result);

isAvailable

Prüfen, ob das aktuelle Gerät einen Barometer-Sensor besitzt.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';

const result = await CapacitorBarometer.isAvailable();
console.log(result);

startMeasurementUpdates

Beginnen Sie mit dem Streaming der Barometer-Updates an den JavaScript-Layer.

Rufe addListener mit dem measurement Event, um die Updates zu empfangen.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';

await CapacitorBarometer.startMeasurementUpdates();

stopMeasurementUpdates

Stop the continuous updates started via startMeasurementUpdates.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';

await CapacitorBarometer.stopMeasurementUpdates();

checkPermissions

Gibt den aktuellen Berechtigungsstatus für den Zugriff auf Barometerdaten zurück.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';

const result = await CapacitorBarometer.checkPermissions();
console.log(result);

requestPermissions

Fordere die Berechtigung zum Zugriff auf Barometerdaten an, falls dies von der Plattform verlangt wird.

import { CapacitorBarometer } from '@capgo/capacitor-barometer';

const result = await CapacitorBarometer.requestPermissions();
console.log(result);

Typ-Referenz

GetMeasurementResult

Alias für die aktuellste Druckmessung.

export type GetMeasurementResult = Measurement;

IsAvailableResult

Rückgabewert von isAvailable.

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

PermissionStatus

Berechtigungsinformationen von checkPermissions und requestPermissions.

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

MeasurementEvent

Event-Payload, das gesendet wird, wenn startMeasurementUpdates aktiv ist.

export type MeasurementEvent = Measurement;

Measurement

Luftdruck- und relative Höhenwerte, die über das Barometer des Geräts erfasst werden.

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

Union der Berechtigungszustände, einschließlich limited für Plattformen, die den Sensorzugriff drosseln können.

export type BarometerPermissionState = PermissionState | 'limited';

PermissionState

Von Capacitor unterstützte Plattform-Berechtigungszustände.

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

Source of Truth

Diese Seite wird aus dem Plugin- src/definitions.ts. Führe den Sync erneut aus, wenn sich der öffentliche API upstream ändert.

Weiter mit Getting Started

Wenn Sie ... verwenden Erste Schritte Um Dashboard- und API-Operationen zu planen, verbinde es mit Verwendung von @capgo/capacitor-barometer für die native Funktion in Verwendung von @capgo/capacitor-barometer, API Übersicht für Details zur Implementierung in der Übersicht zu API, Einführung für das Implementierungsdetail in der Einleitung, API Keys für die Implementierungsdetails in den API Keys und Geräte für die Implementierungsdetails bei Devices.