メインコンテンツへスキップ

スタートガイド

GitHub

AIアシストによるセットアップでプラグインをインストールできます。以下のコマンドを使用して、お使いの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 最初のセンサーイベントが届くまで。

  • Web:利用不可として扱う、 isAvailable() が false です。
  • iOS の相対高度:更新の実行中のみ有効です。
  • バッテリー:呼び出し stopMeasurementUpdates() 完了したら。

ネイティブレイヤーが取得した最新の気圧測定値を取得します。

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

デバイスに気圧センサーが搭載されているかを確認します。

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

JavaScriptレイヤーへの気圧データのストリーミングを開始します。

呼び出す addListener を使用して、 measurement イベントで更新データを受信します。

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

次の方法で開始された継続的な更新を停止します startMeasurementUpdates.

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

気圧計データへのアクセス権限の現在の状態を返します。

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

プラットフォームが必要とする場合、気圧計データへのアクセス権限をリクエストします。

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

最新の気圧サンプルのエイリアス。

export type GetMeasurementResult = Measurement;

返される結果 isAvailable.

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

返される権限情報 checkPermissions と requestPermissions.

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

〜時に発行されるイベントペイロード startMeasurementUpdates がアクティブです。

export type MeasurementEvent = 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;
}

以下を含む権限状態のUnion型 limited センサーアクセスをスロットルできるプラットフォーム向け。

export type BarometerPermissionState = PermissionState | 'limited';

Capacitor がサポートするプラットフォームごとの権限状態。

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

このページはプラグインの src/definitions.tsから生成されています。upstream で公開 API が変更されたら、再度 sync を実行してください。

Getting Startedの続きを進める

「Getting Started からの続き」セクション

使用している場合 スタートガイド ダッシュボードと API の運用を計画するには、これを次と連携させます @capgo/capacitor-barometer の使い方 @capgo/capacitor-barometer の使用におけるネイティブ機能については、 API の概要 「API の概要」の実装の詳細については、 はじめに 「はじめに」における実装の詳細については、 API キー および「API Keys」の実装の詳細については、 デバイス 実装の詳細については Devices を参照してください。