Health
androidx.health
グループ内のすべてのアーティファクトのリストを以下に示します。
アーティファクト | 安定版リリース | リリース候補版 | ベータ版リリース | アルファ版リリース |
---|---|---|---|---|
health-services-client | - | - | - | 1.0.0-alpha03 |
health-connect-client | - | - | - | 1.0.0-alpha03 |
依存関係の宣言
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
に登録するだけで、データ ストリームを受信でき、不要になったコールバックの登録は解除されます。