ヘルスコネクト

ヘルスコネクト

  

API リファレンス
androidx.health.connect.client

ユーザーの健康状態やフィットネスの記録をデベロッパーが読み取り/ 書き込みできるようにします。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2024 年 1 月 10 日	-	-	-	1.1.0-alpha07

データ型へのアクセス権のリクエスト

ユーザーのプライバシーとセキュリティを強化するために、ヘルスコネクトと統合するデベロッパーは、アプリで使用するデータの種類について読み取り/書き込みアクセス権を申告する必要があります。デベロッパーは、アプリの目的に基づいて、使用するデータタイプの有効なユースケースを含める必要があります。詳しくは、健康アプリの申告フォームで情報を提供すると Android のヘルスコネクトの権限を参照してください。

依存関係の宣言

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

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

Groovy

dependencies {
    // Use to implement health connects
    implementation "androidx.health.connect:connect-client:1.1.0-alpha10"
}

Kotlin

dependencies {
    // Use to implement health connects
    implementation("androidx.health.connect:connect-client:1.1.0-alpha10")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

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

新しい問題を報告する

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

バージョン 1.1

バージョン 1.1.0-alpha07

2024 年 1 月 10 日

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

API の変更

• プロファイル ユーザー コンテキストから #getSdkStatus が呼び出された場合は SDK_UNAVAILABLE を返します。（I91df3）。
• SleepStageRecord を削除しました。（/If6ada）。

バグの修正

• バインディング失敗時に、IllegalStateException ではなく RemoteException をスローします。（Id2233）。

バージョン 1.1.0-alpha06

2023 年 10 月 18 日

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

API の変更

• recordingMethod 定義を公開します。（I401fb）。

バグの修正

• 場所がセッションの終了時間より前にする必要があることを示す、演習ルートにドキュメントを追加。（0e51e6）。

バージョン 1.1.0-alpha05

2023 年 10 月 4 日

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

API の変更

• ヘルスコネクトのデータ管理画面に移動するインテントを追加しました。（Ibf591）。
• AggregationResult の非推奨のメソッドを削除しました。（Idbda9）。
• ReadRecordsRequest の作成、レコードの削除と読み取りを行うコンビニエンス API が、具体化されたレコードタイプに追加されました。（If58a5）。

バグの修正

• null の栄養フィールドが Double.MIN_VALUE として返される Android 14 のバグを修正しました。（1aa1d1）。
• Android 14 で、バケットの開始時間と終了時間が同じため、月単位 / 年単位の期間ごとの集計がレスポンスで例外をスローするバグを修正しました。（281313）。

バージョン 1.1.0-alpha04

2023 年 9 月 6 日

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

API の変更

• Java のみ: ChangesResponse の getHasMore() フィールドの名前を hasMore() に変更します。（I80695）。
• Android バージョン間で HealthPermissionsRequestContract#createIntent のチェックを調整。コントラクトにより、すべての権限がヘルス関連の権限であるかどうかがチェックされます。（I143fc）。

バグの修正

• 場所の空のリストを含む ExerciseRoute で ExerciseSessionRecord の作成時にスローされる例外を修正しました。（I45c16）。
• 睡眠セッションを読み取るための SleepSessionRecord のドキュメントとサンプルコードを更新しました。（Idf0de）

バージョン 1.1.0-alpha03

2023 年 7 月 26 日

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

新機能

• エクササイズのルートを読み書きするための API: <ph type="x-smartling-placeholder">
  </ph>
  • 「ExerciseRouteResult」を「ExerciseSessionRecord」に追加しました
  • ExerciseRouteRequestContract を追加しました

API の変更

• ExerciseRouteResult とそのサブクラス（Data、NoData、ConsentRequiredStates）を追加しました。
• 経路の位置情報を保持するスタンドアロン クラスとして ExerciseRoute を追加しました。（I22eed）。
• PERMISSION_WRITE_EXERCISE_ROUTE を追加しました。（I92fc4）。
• ExerciseRouteRequestContract を追加し、HealthPermissionsRequestContract を追加しました。（Ief0e5）。

バグの修正

• エネルギーのキロジュール単位の固定構造（Ie8791）

バージョン 1.1.0-alpha02

2023 年 6 月 21 日

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

バグの修正

• HealthDataSdkService のリークを修正しました（Ia3ba5）
• Android U で権限をリクエストするときは、常に適切な HealthConnect クライアントにリダイレクトします（I6415a）。

バージョン 1.1.0-alpha01

2023 年 6 月 7 日

androidx.health.connect:connect-client:1.1.0-alpha01 がリリースされました。このバージョンは内部ブランチで開発されています。

注: このバージョンは、Android 14（Upside Down Cake）ベータ版 1 SDK 以降でのみコンパイルされます。

新機能

• ヘルスコネクトの Android 14 フレームワーク バージョンのサポート。この SDK は Android 14 の前提条件です。これがないと、アプリは Android 14 のヘルスコネクトと統合できなくなります。
• メタデータを記録する記録メソッドを追加しました。

API の変更

• Session API の変更: <ph type="x-smartling-placeholder">
  </ph>
  • SleepSessionRecord にさまざまな睡眠ステージを追加し、SleepStageRecord を削除しました。
  • ExerciseLap と ExerciseSegment を ExerciseSessionRecord に追加しました。
• 読み取り、変更履歴、挿入、削除オペレーションに対する定期的および 1 日のレート制限（メモリ上限を含む）。
• すべての NutritionRecord フィールドの検証を追加しました。
• HeartRateVariabilityRmssdRecord の検証を追加しました。
• サポートが終了した 2 つの API（HealthConnectClient#isProviderAvailable と HealthConnectClient#isApiSupported）を削除しました。

バグの修正

• すべてのユニット型で単位の等価性を修正しました。等価性がユニットの初期化に使用される型に依存しなくなりました。例:これで、質量グラム(1000) は質量.キログラム(1) と等しくなります。

バージョン 1.0

バージョン 1.0.0-alpha11

2023 年 2 月 22 日

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

API の変更

• ヘルスコネクトを開くために使用するインテントを追加しました。（Ic8055）
• 一部のエクササイズ タイプを削除しました。削除されたタイプの代わりに EXERCISE_TYPE_STRENGTH_TRAINING、EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING、または EXERCISE_TYPE_CALISTHENICS を使用してください。（I7291c）
• サポートが終了した 2 つの API isSdkSupported() と isProviderAvailable() を組み合わせた、新しい API sdkStatus() を追加しました。（Iac89d）
• providerPackageName を受け入れる API を変更して、リストではなく 1 つの文字列を受け入れるようにしました。（I67e0f）

バージョン 1.0.0-alpha10

2023 年 1 月 25 日

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

API の変更

• ExerciseEventRecord、ExerciseLapRecord、ExerciseRepititionRecord、SwimmingStrokesRecord は RecordTypes としてサポートされなくなりました。HealthConnect に対する書き込みと読み取りができなくなります。 HealthConnect 統合からこれらのデータ型への参照をすべて削除します。（If7ca2）
• 新しい文字列ベースの形式で権限が受け入れられるように権限 API を変更しました。この変更に伴い、権限の申告を Android 標準の権限形式に変更することも必要になります。（Ib0a2f）

バージョン 1.0.0-alpha09

2023 年 1 月 11 日

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

新機能

• ヘルスコネクト用に女性の健康に関するデータ型を 2 つ追加しました（IntermenstrualBleedingRecord と MenstruationPeriodRecord）。MenstruationFlow.ENUMs は、Light、Medium、Heavy、Unknown です。

API の変更

• IntermenstrualBleedingRecord を追加しました（Idc470）
• レコードタイプ MenstruationPeriodRecord を追加しました（Iea545）

バージョン 1.0.0-alpha08

2022 年 12 月 7 日

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

API の変更

• サポートされている新しいレコードタイプとして BodyWaterMass、HeartRateVariabilityRmssdRecord を追加しました。（Ifd58f）
• サポートされている RecordTypes として HipCircumferenceRecord、WaistCircumferenceRecord を削除しました。（I62fb9）
• MenstruationFlowRecord.flow を stringdef から intdefs に変更しました。（I0369f）
• パフォーマンスを向上させるために、Strings を含む列挙型のようなレコード フィールドを Integers に変更しました。（I3b295）
• ExerciseSession、ExerciseRepetitions、SleepStage の列挙型のようなフィールドを文字列から整数型に変更しました。（Id32a9）
• ExerciseSessionRecord.ACTIVE_TIME_TOTAL->EXERCISE_DURATION_TOTAL に変更しました。（I5d7bd）
• CervicalMucus 列挙型に「Unusual」を追加しました。より明確にするために「Clear」を「Eggwhite」に変更しました。CervicalMucus#appearance と #sensation を StringDefs から IntDefs に変更しました。（I3ac51）
• DeviceTypes 列挙型の StringDef が [Device] の IntDefs に移動しました。（I3abf3）
• 互換性のある実装がない SDK バージョンで false を返す HealthConnectClient.isApiSupported() を追加しました。HealthConnectClient.isAvailable->isProviderAvailable に変更しました。（I3674e）

バグの修正

• 1 未満の HeartRate beatsPerMinute 値を禁止します。（I6052f）
• @JvmDefaultWithCompatibility アノテーションを追加しました。（I8f206）

バージョン 1.0.0-alpha07

2022 年 10 月 24 日

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

API の変更

• デフォルト値がないレコード引数は、デフォルト値がある引数の前に配置されます。整合性を保つため、Instant 引数と ZoneOffset 引数は常に先頭に配置されます。（Id618c）
• HealthConnectClient.getOrCreate#packageNames を providerPackageNames に変更しました。（Id81e4）

バグの修正

• レコード フィールド値の検証を追加しました。指定された値が妥当な範囲の外にある場合、極端に誤った値について IllegalArgumentExceptions をスローします。（Ie171d）
• 該当する場合は、レコード開始時間が終了時間より前かどうかを検証します。（I02460）

バージョン 1.0.0-alpha06

2022 年 10 月 5 日

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

バグの修正

• サービス接続のライフサイクルを改善しました。（If2bd5）
• サービス接続で例外が発生した場合に NPE がクラッシュするバグを修正しました。（I13546）

バージョン 1.0.0-alpha05

2022 年 9 月 21 日

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

API の変更

• Metadata.uid を Metadata.id に変更し、関連する CRUD API 全体で用語 recordId を統一しました。（I3d1d2）
• PermissionController.createRequestPermissionActivityContract をインスタンス メソッドではなく静的メソッドにしました。PermissionController.createRequestPermissionResultContract に変更しました。（Icd2fe）
• BloodGlucoseRecord の単位タイプとして BloodGlucose を追加しました。（I97678）
• MenstruationRecord を MenstruationFlowRecord に変更しました。（I3b88e）

バグの修正

• クライアント プロセスからフォアグラウンドのデータを伝播しない意図しない動作を修正しました。（Ifb44c）

バージョン 1.0.0-alpha04

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

androidx.health.connect への移行

1.0.0-alpha04 以降、androidx.health:health-connect-client は androidx.health.connect:connect-client に移行されました。以前のバージョンのヘルスコネクトについては、androidx.health ページをご覧ください。

移行するには、単に依存関係のインポートを androidx.health:health-connect-client:1.0.0-alpha03 から androidx.health.connect:connect-client:1.0.0-alpha04 に変更します。

新機能

• API 呼び出し用の組み込みのデバッグログをオプションとして追加しました（リンク）。

API の変更

• メタデータ clientId を clientRecordId に、clientVersion を clientRecordVersion に変更しました。（リンク）
• メタデータの uid を読みやすくし、null 可能性はなくなりました。（リンク）
• 質量単位にポンドを追加しました（リンク）
• DeletionChange.deleteUid を uid に変更しました（リンク）
• Permission を HealthPermission に変更しました。これにより、Android フレームワークの権限の曖昧さを回避できます。（リンク）

バグの修正

• エネルギーのカロリー単位の誤りに関する回帰問題を修正しました（リンク）
• 一部のレコード型の集約に関する回帰問題を修正しました（リンク）