__CAPGO_KEEP_4__
@capgo/capacitor-health デバイスAPI オープンソース

ヘルス Capacitor プラグイン

ネイティブの健康プラットフォームから健康とフィットネスデータにアクセス

インストール

bun add @capgo/capacitor-health bunx cap sync
npm、pnpm、またはyarn
  • npm install @capgo/capacitor-health
  • pnpm add @capgo/capacitor-health
  • yarn add @capgo/capacitor-health

ガイド

CapacitorでHealthを使用する方法

デバイスでテスト

Capacitor Health ダウンロードしてください。Capgoアプリ、QRコードをスキャンします。code

ヘルス プラグイン プレビュー QR code

@capgo/capacitor-healthを使用

Capacitor プラグインは、Apple HealthKitとHealth Connectからデータを操作するために使用されます。

インストール

bun add @capgo/capacitor-health
bunx cap sync

bunx cap sync プラグインのネイティブ codeをプロジェクトにコピーします。プラグインのアップグレード後は、再度実行してください。

インポート

import { Health } from '@capgo/capacitor-health';

APIの概要

方法 概要
isAvailable 現在のプラットフォームがネイティブヘルスSDKをサポートしているかどうかを返します。
requestAuthorization 指定されたデータタイプへの読み書きアクセスを要求します。
checkAuthorization ユーザーに質問することなく、指定されたデータタイプの認可状態を確認します。
readSamples 指定されたデータタイプのサンプルを指定された時間枠内で読み取ります。
saveSample ネイティブヘルスストアに単一のサンプルを書き込みます。
openHealthConnectSettings Androidのみ:ヘルス接続設定画面を開きます。iOSでは何も行われません。
showPrivacyPolicy Androidのみ:アプリのプライバシーポリシーをヘルス接続で表示します。iOSでは何も行われません。
queryWorkouts ネイティブヘルストアからワークアウトセッションをクエリします。iOS(ヘルスキット)とAndroid(ヘルス接続)でサポートされています。
queryAggregated ネイティブヘルストアから集計されたヘルスデータをクエリします。データを時間枠(1時間、1日、1週間、1か月)に集計し、合計、平均、最小値、最大値などの演算を実行します。この方法は、大規模な日付範囲で個々のサンプルを取得するよりも効率的です。

例

isAvailable()

現在のプラットフォームがネイティブヘルスSDKをサポートしているかどうかを返します。

import { Health } from '@capgo/capacitor-health';

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

requestAuthorization()

提供されたデータタイプに読み書きアクセスします。

import { Health } from '@capgo/capacitor-health';

const result = await Health.requestAuthorization({ read: ['steps'] });
console.log(result);

checkAuthorization()

提供されたデータタイプの認証状態を確認します。ユーザーに質問を求めないようにします。

import { Health } from '@capgo/capacitor-health';

const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);

readSamples()

指定された時間枠内で指定されたデータタイプのサンプルを読み取ります。

import { Health } from '@capgo/capacitor-health';

const result = await Health.readSamples({ dataType: 'steps' });
console.log(result);

saveSample()

ネイティブのヘルスストアに単一のサンプルを書き込みます。

import { Health } from '@capgo/capacitor-health';

await Health.saveSample({
  dataType: 'steps',
  value: 1,
});

openHealthConnectSettings()

Androidでは、ヘルス接続設定画面を開きます。iOSでは何も実行されません。

import { Health } from '@capgo/capacitor-health';

await Health.openHealthConnectSettings();

上の表には、9つの基本メソッドがリストされています。リスナーとバージョンヘルパー、各メソッドの完全な契約は、__CAPGO_KEEP_0__ リポジトリにドキュメントされています。 GitHub リファレンス.

ドキュメント

@capgo/capacitorの健康監視を継続して

Capacitor Healthプラグインを使用している場合 Using @capgo/capacitor-health Capacitor plugin のネイティブワークを計画するには、接続する @capgo/capacitor-health Capacitor-@capgo/capacitor-health Capacitor Healthプラグインの実装詳細については、Capacitor Healthプラグインを参照してください Capacitor Healthプラグインのディレクトリ Capgo プラグインディレクトリ for the product workflow in Capgo Plugin Directory, Capacitor プラグイン Capgo for Capacitor の実装詳細については、Capgo によって提供されるプラグインです。 Capacitor Healthプラグインの追加または更新 Capacitor-Healthプラグインの実装詳細については、追加または更新するプラグインの詳細を参照してください。

FAQ

Capacitor-HealthプラグインのFAQ

Capacitor Health を Capacitor アプリにインストールする方法は何ですか。

「bun add @capgo/capacitor-health」(または「npm install @capgo/capacitor-health」)を実行し、次に「bunx cap sync」を実行してiOSとAndroidのプロジェクトがネイティブcodeを取得できるようにします。次に、@capgo/capacitor-healthをアプリcodeからインポートします。

React、Vue、Angularと一緒に@capgo/capacitor-healthが動作することはできますか?

Yes. Health is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Which Capacitor version does @capgo/capacitor-health support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

は@capgo/capacitor-healthが無料でオープンソースですか?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-health/ and the package is free to install from npm. Bug reports and pull requests are welcome.

アップデート code がアプリストアレビューなしでHealthを使用できるか?

プラグインをインストールまたはアップグレードするとネイティブcodeが変更されるため、新しいストアビルドが必要になります。その後、JavaScript、HTML、CSSの変更がプラグインを呼び出すと、Capgoのライブアップデートで即時配信できます。

アプリレビューの待たずにShip Healthを変更

プラグインがストアビルドに追加されたら、Capgoでライブアップデートが実行されます。JavaScript、HTML、CSSの変更がユーザーに数分で反映されます。

Capgoから始めましょう