Health
androidx.health
グループ内のすべてのアーティファクトのリストを以下に示します。
アーティファクト | 安定版リリース | リリース候補版 | ベータ版リリース | アルファ版リリース |
---|---|---|---|---|
health-services-client | - | - | - | 1.0.0-alpha03 |
health-connect-client | - | - | - | 1.0.0-alpha01 |
依存関係の宣言
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-alpha01" }
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-alpha01") }
フィードバック
お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。
詳細については、Issue Tracker のドキュメントをご覧ください。
ヘルスコネクト クライアント バージョン 1.0
バージョン 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
に登録するだけで、データ ストリームを受信でき、不要になったコールバックの登録は解除されます。