시작하기

설치

AI-Assisted Setup으로 플러그인을 설치할 수 있습니다. 다음 명령어로 AI 도구에 Capgo 스킬을 추가하세요:

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

그런 다음 아래 프롬프트를 사용하세요:

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

수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:

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);
});

예: 단일 읽기

호출하세요 startMeasurementUpdates() 먼저. getMeasurement() 반환합니다 0 첫 번째 센서 이벤트가 도착할 때까지.

자주 하는 실수

• 웹: 사용할 수 없는 것으로 처리, isAvailable() 는 false입니다.
• iOS 상대 고도: 업데이트 실행 중에만 유효합니다.
• 배터리: 호출 stopMeasurementUpdates() 완료되면.

API 개요

getMeasurement

네이티브 레이어에서 캡처한 최신 기압 측정값을 가져옵니다.

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

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

isAvailable

현재 기기에 기압 센서가 있는지 확인합니다.

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

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

startMeasurementUpdates

JavaScript 레이어로 기압 업데이트 스트리밍을 시작합니다.

호출하세요 addListener 를 사용하여 measurement 이벤트를 통해 업데이트를 수신합니다.

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

await CapacitorBarometer.startMeasurementUpdates();

stopMeasurementUpdates

다음 명령어로 시작된 연속 업데이트를 중지합니다: startMeasurementUpdates.

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

await CapacitorBarometer.stopMeasurementUpdates();

checkPermissions

기압계 데이터 접근에 대한 현재 권한 상태를 반환합니다.

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

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

requestPermissions

플랫폼에서 요구하는 경우 기압계 데이터 접근 권한을 요청합니다.

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

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

타입 레퍼런스

GetMeasurementResult

가장 최근 기압 샘플의 별칭

export type GetMeasurementResult = Measurement;

IsAvailableResult

반환되는 결과: isAvailable.

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

PermissionStatus

반환되는 권한 정보: checkPermissions 및 requestPermissions.

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

MeasurementEvent

발생 시 이벤트 페이로드: startMeasurementUpdates 활성 상태일 때.

export type MeasurementEvent = Measurement;

Measurement

기기 기압계에서 샘플링한 기압 및 상대 고도 값입니다.

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

다음을 포함하는 권한 상태 유니온 limited 센서 접근을 throttle할 수 있는 플랫폼용.

export type BarometerPermissionState = PermissionState | 'limited';

PermissionState

Capacitor에서 지원하는 플랫폼 권한 상태.

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

Source of Truth

이 페이지는 플러그인의 src/definitions.tsupstream에서 public API가 변경되면 sync를 다시 실행하세요.

시작하기 다음 단계

사용 중이라면 시작하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-barometer 사용하기 @capgo/capacitor-barometer 사용 시 네이티브 기능을 위해, API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 API Keys의 구현 세부 사항은, 기기 Devices의 구현 세부 사항은.