Health

  
プラットフォームに依存しない方法で高性能のヘルスケア アプリを作成します。

androidx.health グループ内のすべてのアーティファクトのリストを以下に示します。

アーティファクト 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
health-services-client - - - 1.0.0-alpha03
health-connect-client - - - 1.0.0-alpha03
このライブラリの最終更新日: 2022 年 7 月 27 日

依存関係の宣言

Health への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    implementation "androidx.health:health-services-client:1.0.0-alpha03"

    // To build applications that can read or write user's health and fitness records.
    implementation "androidx.health:health-connect-client:1.0.0-alpha03"
}

Kotlin

dependencies {
    implementation("androidx.health:health-services-client:1.0.0-alpha03")

    // To build applications that can read or write user's health and fitness records.
    implementation("androidx.health:health-connect-client:1.0.0-alpha03")
}

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

ヘルスコネクト クライアント バージョン 1.0

バージョン 1.0.0-alpha03

2022 年 7 月 27 日

androidx.health:health-connect-client:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください。

新機能

  • 新しい API の変更の概要: 読み取り、書き込み、および集計 API に単位のセットが追加されました。アプリは、任意の単位（たとえば NutritionRecord 栄養素の場合はグラムやミリグラム）でレコードの取得または書き込みを行えるようになりました。

API の変更

  • 各種のリクエスト レスポンス オブジェクトで List<DataOrigin> を Set<DataOrigin> に修正しました。（I42342）
  • パワー -> エネルギーの基礎合計カロリーの単位を修正しました。（I0b429）
  • 級数レコード内の級数サンプルクラスを次のように移行しました。（Ica9bb）
    • CyclingPedalingCadence -> CyclingPedalingCadenceRecord.Sample
    • HeartRate -> HeartRateRecord.Sample
    • StepsCadence -> StepsCadenceRecord.Sample
  • HealthDataRequestPermission クラスを非推奨にして PermissionController.createRequestPermissionActivityContract に置き換えました。これにより、検出可能性が向上し、パラメータ化の統合が促進されます。（I81e7f）
  • ボリュームに米国の液量オンスを追加しました。（I5f03d）
  • 単位タイプとして速度を追加しました。（I1d574）
  • 単位タイプとしてパーセンテージを追加しました。（I08f23）
  • 単位タイプとして圧力を追加しました。（Ifb01f）
  • 単位タイプとして質量を追加しました。（Ifd81a）
  • 単位タイプとしてボリュームを追加しました。（I59ad1）
  • 単位タイプとしてパワーを追加しました。PowerRecord クラス内のパワー級数サンプルクラスを移行しました。（I5b1e5）
  • 単位タイプとしてエネルギーを追加しました。（I983ae）
  • 単位タイプとして温度を追加しました。（I4cdb5）
  • Activity の参照の名前を、次のようにエクササイズ固有の名前に変更しました。（I3f936）
    • ActivityLap -> ExerciseLapRecord に名前変更
    • ActivityEvent -> ExerciseEventRecord に名前変更
    • Repetitions -> ExerciseRepetitionsRecord に名前変更
    • ActivitySession -> ExerciseSessionRecord に名前変更
  • パッケージ メタデータをレコードの下に移動してネストしました。（Ie0835）
  • 残りのすべてのレコードでは長さ単位を使用しました。（Ib10dd）:
    • ActivityLapRecord
    • ElevationGainedRecord
    • HeightRecord
    • HipCircumferenceRecord
    • WaistCircumferenceRecord
  • 単位タイプとして長さを追加しました。（Idae39）
  • CervicalMucus の説明の用語を更新しました。（I25a2b）
    • CervicalMucus.Amount -> CervicalMucusRecord.Texture
    • CervicalMucus.Appearance -> CervicalMucusRecord.Sensation
  • すべてのレコードクラス名に接尾辞「Record」を追加しました。（I1ffc2）

バグの修正

  • リリースのフレーバーと minifyEnabled が true の状態で lib がビルドされたときの ProGuard の問題を修正しました。（I78933）
  • 一般公開用ではないドキュメントを非表示にします。（I7a08f）
  • 独自の protobuf 依存関係を持つ可能性があるクライアントの問題を修正しました（https://android-review.googlesource.com/c/platform/frameworks/support/+/2105430）。

バージョン 1.0.0-alpha02

2022 年 6 月 1 日

androidx.health:health-connect-client:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

API の変更

  • AggregationResult の hasMetric と getMetric が非推奨になり、contains 演算子と get 演算子が追加されました。（I7cc7c）
  • OvulationTest.Result.HIGH と OvulationTest.Result.INCONCLUSIVE を追加します。（I9f9c4）

バグの修正

  • SDK 要件を 26 に減らします。（I6d201）

バージョン 1.0.0-alpha01

2022 年 5 月 11 日

androidx.health:health-connect-client:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

  • 他のアプリと共有されているフィットネスや健康状態の記録を読み取るための API
  • 他のアプリと共有するフィットネスや健康状態の記録を書き込むための API
  • アクセス可能なレコードの集計指標を取得するための API
  • 他のアプリによる記録の追加変更（挿入、更新、削除）を取得するための API
  • 健康データへのアクセス許可をユーザーに促すための API
  • 健康データへのアクセス許可を確認したり取り消したりするための API

ヘルスサービス クライアント バージョン 1.0

バージョン 1.0.0-alpha03

2021 年 11 月 3 日

androidx.health:health-services-client:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください。

新機能

  • SDK は、Health Services APK で IPC 接続が切断された場合に、測定、エクササイズ リスナー、およびパッシブ モニタリング コールバックの登録リクエストを自動的に再登録します。

API の変更

  • ヘルスサービス クライアントは現在 Wear3 でのみサポートされているため、SDK ライブラリの minSdkVersion は API レベル 30 に引き上げられました。

バージョン 1.0.0-alpha02

2021 年 9 月 29 日

androidx.health:health-services-client:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

API の変更

  • ExerciseClient がエクササイズの準備をサポートするようになりました。これにより、クライアントはセンサーをウォームアップし、GPS 修正などを待ってからエクササイズを開始できます。
  • CumulativeDataPoints および StatisticalDataPoints AggregateDataPoint クラスを導入し、アクティブなエクササイズ中にトラッキングされる集計指標をより適切にモデル化できるようにしました。CumulativeDataPoints は、集計された間隔データ型（エクササイズ中の合計距離など）の累積値を保持し、StatisticalDataPoints は、サンプリングされたデータポイント（HeartRateBpm の最小値、最大値、平均値など）の集計値をモデル化します。これは以前の AGGREGATE_* DataType に代わるものであり、getLatestAggregateMetrics() を介して ExerciseUpdate 内でアクセスできます。AGGREGATE_* DataType はサポート対象外になりました。
  • PassiveMonitoring イベントの名前が PassiveGoals に変更されました。このイベントは、日次指標（DAILY_STEPS など）のデータ型について、目標の設定と目標達成時の通知の受け取りをサポートします。
  • 新しい HrAccuracy クラス、LocationAccuracy クラス、LocationAvailability クラスの導入により、心拍数、位置情報の精度、可用性のモデル化を改善しました。
  • ExerciseConfig と新しい PassiveMonitoringConfig フィールドの名前を改善し、GPS に裏付けられたデータをリクエストする ExerciseConfig.shouldEnableGps を導入しました。

バグの修正

  • 下位互換性のサポートを強化するため、proto に支えられた IPC トランスポートに移行しました。

バージョン 1.0.0-alpha01

2021 年 5 月 18 日

androidx.health:health-services-client:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

初回リリースの機能

Health Services ライブラリには統一された一連の API が用意されており、デベロッパーはデバイス固有のセンサーの実装と統合できます。Wear OS 3 エミュレータおよび近日発売予定のデバイスですぐに使用できます。今後、他のプラットフォームもサポートされる予定です。この初回リリースには、3 つのトップレベル API サーフェス（ExerciseClient、PassiveMonitoringClient、MeasureClient）が含まれています。

ExerciseClient

ExerciseClient は、アクティブなワークアウトをトラッキングするアプリ向けです。ウォーキングやランニングから、ダンスや水球まで、最大で 82 種類の ExerciseType を利用できます。このようなエクササイズのトラッキングでは、デバイスで利用できるエクササイズのタイプとハードウェアに応じて、50 種類の DataType が用意されています。まず、ExerciseConfig で関連情報を指定し、exerciseClient.startExercise を呼び出して、更新リスナーで進捗状況をリッスンします。

PassiveMonitoringClient

PassiveMonitoringClient は、アプリで 1 日を通してユーザーのアクティビティをトラッキングする場合に最適です。PendingIntent を DataType のセットに登録して、一括変更を処理できるようになります。また、一定のステップ数への到達など、Event を指定することもできます。

MeasureClient

運動中や 1 日を通してではなく、その瞬間の心拍数などを測定する必要がある場合もあります。そのような場合は、MeasureClient が最適です。コールバックをサポートされている DataType に登録するだけで、データ ストリームを受信でき、不要になったコールバックの登録は解除されます。