시작하기

설치

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

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

그다음 아래 prompt를 사용하세요:

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

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

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

현재 기기에 기압계(barometer) 센서가 포함되어 있는지 확인합니다.

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 센서 액세스 제한이 가능한 플랫폼용.

export type BarometerPermissionState = PermissionState | 'limited';

PermissionState

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

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

기준 소스

이 페이지는 플러그인의 src/definitions.ts에서 생성되었습니다. public API가 업스트림에서 변경되면 동기화를 다시 실행하세요.

Getting Started에서 계속하기

사용 중인 경우 시작하기 대시보드와 API 운영을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-barometer 사용하기 @capgo/capacitor-barometer를 사용하여 네이티브 기능을 구현할 때, API 개요 API Overview의 구현 상세 내용은 소개 Introduction의 구현 상세 내용은 API 키 API Keys의 구현 세부 사항은, 디바이스 Devices의 구현 세부 사항은.