1. はじめに
ヘルスコネクトとは
ヘルスコネクトは、Android アプリ デベロッパー向けの健康データ プラットフォームです。ユーザーの健康とフィットネスのデータにアクセスできる一元化されたインターフェースと、デバイスに依存しない一貫した機能動作を実現できます。ヘルスコネクトでは、健康とフィットネスに関するデータがデバイスに安全に保存されるほか、アクセスを詳細に制御して透明性を確保できます。
ヘルスコネクトの仕組み
ヘルスコネクトは、アクティビティ、睡眠、栄養、身体測定、心拍数や血圧などの指標を含む、50 を超える一般的な健康とフィットネスに関するデータ型とカテゴリをサポートしています。
デベロッパーはユーザー権限で、標準化されたスキーマと API の動作を使用して、ヘルスコネクトに対する読み取りや書き込みを安全に行えます。ユーザーは、プライバシー設定を詳細に制御し、どのアプリがデータへのアクセスをリクエストしているかをいつでも細かく管理できます。ヘルスコネクトのデータはデバイス上に保存され、暗号化されます。ユーザーは、アクセスを遮断したり、デバイス上で不要なデータを削除したりできるほか、複数のアプリを使用する場合に、複数のデータソースで優先順位を付けることもできます。
ヘルスコネクトのアーキテクチャ
ヘルスコネクトの主な要素とアーキテクチャのコンポーネントは次のとおりです。
- クライアント アプリ - ヘルスコネクトと統合するために、最初にクライアント アプリが SDK を健康&フィットネス アプリにリンクします。これにより、Health Connect API とやり取りするための API サーフェスが提供されます。
- ソフトウェア開発キット - この SDK で、クライアント アプリが IPC を介してヘルスコネクト APK と通信できるようになります。
- ヘルスコネクト APK - ヘルスコネクトを実装する APK です。権限管理コンポーネントとデータ管理コンポーネントの両方が含まれています。ヘルスコネクト APK はユーザーのデバイスで直接利用できるようになるため、ヘルスコネクトはアカウント中心ではなくデバイス中心になります。
- 権限の管理: ヘルスコネクトには、アプリがデータを表示する権限をユーザーにリクエストするためのユーザー インターフェースがあります。既存のユーザー権限のリストも表示されます。これにより、ユーザーはさまざまなアプリに対して付与または拒否したアクセス権を、簡単に管理できます。
- データの管理: ヘルスコネクトは、ユーザーの歩数、サイクリング速度、心拍数など、サポートされているデータの種類について、記録されたデータの概要をユーザー インターフェースに表示します。
作成するアプリの概要
この Codelab では、ヘルスコネクトと統合されたシンプルな健康&フィットネス アプリを作成します。このアプリでは次の処理を行います。
- データアクセスに関するユーザー権限の取得と確認。
- ヘルスコネクトへのデータの書き込み。
- ヘルスコネクトからの集計データの読み取り。
学習内容
- ヘルスコネクトの統合開発をサポートする環境を設定する方法。
- 権限を取得して権限チェックを実行する方法。
- ヘルスコネクト プラットフォームに健康やフィットネスに関するデータを提供する方法。
- デバイス上のデータ ストレージを活用する方法。
- Google が提供するデベロッパー ツールを使用してアプリを検証する方法。
必要なもの
- Android Studio の最新の安定版。
- Android SDK バージョン 28(Pie)以降を搭載した Android モバイル デバイス。
2. セットアップ
ヘルスコネクトをインストールする
ヘルスコネクトは Play ストアで入手できます。モバイル デバイスにヘルスコネクトをインストールし、ヘルスコネクト SDK を使用してアプリから送信されたすべてのリクエストを処理します。QR コードをスキャンして、ヘルスコネクトをインストールします。
サンプルコードを取得する
git がインストールされている場合は、以下のコマンドをそのまま実行してこのリポジトリからコードのクローンを作成できます。git がインストールされているかどうかを確認するには、ターミナルまたはコマンドラインで「git --version
」と入力し、正しく実行されることを確認します。
git clone https://github.com/android/android-health-connect-codelab.git cd android-health-connect-codelab
git がない場合は、次のボタンをクリックして、この Codelab のすべてのコードをダウンロードできます。
サンプル ディレクトリには、この Codelab の start
コードと finished
コードが含まれています。Android Studio の [Project] ビューに、次の 2 つのモジュールが表示されます。
start
: このプロジェクトのスターター コード。これに変更を加えて Codelab を完了します。finished
: この Codelab の完成したコード。作業のチェックに使用します。
「start」コードを確認する
Codelab サンプルアプリには Jetpack Compose によって構築された基本的な UI があり、次の画面が用意されています。
WelcomeScreen
: アプリのランディング ページです。このページに、ヘルスコネクトの状態(インストール済み、未インストール、サポート対象外)に応じたメッセージが表示されます。PrivacyPolicyScreen
: アプリでの権限の使用方法を説明します。ユーザーがヘルスコネクトの権限ダイアログでプライバシー ポリシーのリンクをクリックすると表示されます。InputReadingsScreen
: シンプルな体重のレコードの読み取りと書き込みを行います。ExerciseSessionScreen
: ここにユーザーがエクササイズ セッションを挿入して一覧表示します。レコードをクリックすると、ExerciseSessionDetailScreen
が表示され、そのセッションに関連するデータが表示されます。DifferentialChangesScreen
: 変更トークンの取得と、ヘルスコネクトからの新しい変更の取得を行います。
HealthConnectManager
: ヘルスコネクトとのやり取りを行うすべての関数が格納されます。この Codelab では、基本的な機能を完成させるための手順を詳細に説明します。start
ビルド内の <!-- TODO:
文字列には、この Codelab 内の対応するセクションがあり、プロジェクトに挿入するためのサンプルコードが提供されています。
まず、ヘルスコネクトをプロジェクトに追加します。
ヘルスコネクト クライアント SDK を追加する
ヘルスコネクト SDK の使用を開始するには、build.gradle
ファイルに依存関係を追加する必要があります。ヘルスコネクトの最新バージョンを確認するには、Jetpack ライブラリのリリースをご覧ください。
dependencies {
// Add a dependency of Health Connect SDK
implementation "androidx.health.connect:connect-client:1.0.0-alpha11"
}
ヘルスコネクトの公開設定を宣言する
アプリ内でヘルスコネクトとやり取りするには、AndroidManifest.xml
でヘルスコネクト パッケージ名を宣言します。
<!-- TODO: declare Health Connect visibility -->
<queries>
<package android:name="com.google.android.apps.healthdata" />
</queries>
プロジェクトを実行する
すべての設定を終えたら、start
プロジェクトを実行します。この時点で、「ヘルスコネクトはこのデバイスにインストールされています」と表示されるウェルカム画面とメニュー ドロワーが表示されるはずです。ヘルスコネクトとやり取りを行う機能については、後のセクションで追加します。
3. 権限の管理
ヘルスコネクトでは、権限のリクエストをアプリで使用されるデータ型に制限することがデベロッパーに推奨されます。権限を包括的にリクエストすると、アプリに対するユーザーの信頼度が低下し、ユーザーの信用を損なう可能性があります。権限リクエストが 3 回以上拒否されると、アプリがロックアウトされます。その結果、権限のリクエストが表示されなくなります。
この Codelab では、次の権限のみが必要です。
- エクササイズ セッション
- 心拍数
- 歩数
- 総消費カロリー
- 体重
権限を宣言する
アプリが読み書きするデータ型はすべて、AndroidManifest.xml
内で権限を使用して宣言する必要があります。バージョン alpha10
以降のヘルスコネクトでは、標準的な Android 権限の宣言形式を使用します。
必要なデータ型の権限を宣言するには、<uses-permission>
要素を使用して権限にそれぞれの名前を割り当てます。<manifest>
タグ内にネストします。権限とそれに対応するデータ型の一覧については、データ型のリストをご覧ください。
<!-- TODO: declare Health Connect permissions -->
<uses-permission android:name="android.permission.health.READ_HEART_RATE"/>
<uses-permission android:name="android.permission.health.WRITE_HEART_RATE"/>
<uses-permission android:name="android.permission.health.READ_STEPS"/>
<uses-permission android:name="android.permission.health.WRITE_STEPS"/>
<uses-permission android:name="android.permission.health.READ_EXERCISE"/>
<uses-permission android:name="android.permission.health.WRITE_EXERCISE"/>
<uses-permission android:name="android.permission.health.READ_TOTAL_CALORIES_BURNED"/>
<uses-permission android:name="android.permission.health.WRITE_TOTAL_CALORIES_BURNED"/>
<uses-permission android:name="android.permission.health.READ_WEIGHT"/>
<uses-permission android:name="android.permission.health.WRITE_WEIGHT"/>
AndroidManifest.xml
でインテント フィルタを宣言して、そうした権限をアプリでどのように使用するかを説明するインテントを処理します。アプリはこのインテントを処理して、ユーザーデータの使用方法と処理方法を説明したプライバシー ポリシーを表示する必要があります。ユーザーがヘルスコネクトの権限ダイアログでプライバシー ポリシーのリンクをタップすると、このインテントがアプリに送信されます。
<!-- TODO: Add intent filter to handle permission rationale intent -->
<intent-filter>
<action android:name="androidx.health.ACTION_SHOW_PERMISSIONS_RATIONALE" />
</intent-filter>
次にアプリを再度開いて、宣言された権限を確認します。メニュー ドロワーの [Settings] をクリックして、[Health Connect Settings] 画面に移動します。次に、[App permissions] をクリックすると、リストに [Health Connect Codelab] が表示されます。[Health Connect Codelab] をクリックして、対象のアプリの読み取り / 書き込みアクセス権のデータ型のリストを表示します。
権限をリクエストする
権限を管理する際は、ユーザーをヘルスコネクトの設定に直接誘導するほかに、Health Connect API を介してアプリから権限をリクエストすることもできます。ユーザーはいつでも権限を変更する可能性があるため、必要な権限が利用できるかどうかをアプリでチェックしてください。この Codelab プロジェクトでは、データの読み取りまたは書き込みの前にチェックを行い、権限リクエストを送信します。
HealthConnectClient
が Health Connect API のエントリ ポイントです。HealthConnectManager.kt
で、HealthConnectClient
インスタンスを取得します。
private val healthConnectClient by lazy { HealthConnectClient.getOrCreate(context) }
アプリ内で権限リクエスト ダイアログを開始するには、まず、必要なデータ型の権限セットを作成します。使用するデータ型に対する権限のみをリクエストする必要があります。
たとえば、[Record weight] 画面では、体重の読み取り / 書き込み権限のみを付与する必要があります。次のコードのように、InputReadingsViewModel.kt
に権限セットを作成しました。
val permissions = setOf(
HealthPermission.getReadPermission(WeightRecord::class),
HealthPermission.getWritePermission(WeightRecord::class),
)
次に、権限のリクエストを実行する前に、権限が付与されているかどうかを確認します。HealthConnectManager.kt
で、getGrantedPermissions
を使用して、必要なデータ型の権限が付与されているかどうかを確認します。権限リクエストを実行するには、PermissionController.createRequestPermissionResultContract()
を使用して ActivityResultContract
を作成する必要があります。このコードは、必要な権限が付与されていない場合に実行する必要があります。
suspend fun hasAllPermissions(permissions: Set<String>): Boolean {
return healthConnectClient.permissionController.getGrantedPermissions().containsAll(permissions)
}
fun requestPermissionsActivityContract(): ActivityResultContract<Set<String>, Set<String>> {
return PermissionController.createRequestPermissionResultContract()
}
Codelab サンプルアプリで、必要なデータ型に権限を付与していない場合、画面に [Request permissions] ボタンが表示されることがあります。[Request permissions] をクリックして、ヘルスコネクトの権限ダイアログを開きます。必要な権限を許可して、Codelab アプリに戻ります。
4. データを書き込む
ヘルスコネクトへのレコードの書き込みを開始します。体重のレコードを書き込むには、体重の入力値を含む WeightRecord
オブジェクトを作成します。ヘルスコネクト SDK はさまざまな単位クラスをサポートしています。たとえば、Mass.kilograms(weightInput)
を使用すると、ユーザーの体重をキログラム単位で設定できます。
基本的に、ヘルスコネクトに書き込むデータには常にゾーン オフセット情報を指定するようにします。データの書き込み時にゾーン オフセット情報を指定すると、ヘルスコネクトのデータを読み取った際にタイムゾーン情報が提供されます。
体重レコードを作成したら、healthConnectClient.insertRecords
を使ってヘルスコネクトにデータを書き込みます。
/**
* TODO: Writes [WeightRecord] to Health Connect.
*/
suspend fun writeWeightInput(weightInput: Double) {
val time = ZonedDateTime.now().withNano(0)
val weightRecord = WeightRecord(
weight = Mass.kilograms(weightInput),
time = time.toInstant(),
zoneOffset = time.offset
)
val records = listOf(weightRecord)
try {
healthConnectClient.insertRecords(records)
Toast.makeText(context, "Successfully insert records", Toast.LENGTH_SHORT).show()
} catch (e: Exception) {
Toast.makeText(context, e.message.toString(), Toast.LENGTH_SHORT).show()
}
}
次に、アプリを実行します。[Record weight] をクリックし、新しい体重レコードをキログラム単位で入力します。体重レコードがヘルスコネクトに正常に書き込まれたかどうかを確認するには、ヘルスコネクト アプリの設定を開き、[Data and access] -> [Body measurements] -> [Weight] -> [See all entries] をクリックします。ヘルスコネクト Codelab から書き込まれた新しい体重レコードが表示されます。
エクササイズ セッションを書き込む
セッションとは、ユーザーがアクティビティを実施する期間です。ヘルスコネクトのエクササイズ セッションには、ランニングからバドミントンまで、さまざまなものがあります。セッションにより、ユーザーは時間ベースのパフォーマンスを測定できます。このデータには、一定期間にわたって測定された一連の瞬間的なサンプル(アクティビティ中の連続的な心拍数や位置情報のサンプルなど)が記録されます。
次の例は、エクササイズ セッションを書き込む方法を示しています。healthConnectClient.insertRecords
を使用して、セッションに関連付けられた複数のデータレコードを挿入します。この例の挿入リクエストには、ExerciseType
を含む ExerciseSessionRecord
、歩数を含む StepsRecord
、Energy
を含む TotalCaloriesBurnedRecord
、および一連の HeartRateRecord
サンプルが含まれます。
/**
* TODO: Writes an [ExerciseSessionRecord] to Health Connect.
*/
suspend fun writeExerciseSession(start: ZonedDateTime, end: ZonedDateTime) {
healthConnectClient.insertRecords(
listOf(
ExerciseSessionRecord(
startTime = start.toInstant(),
startZoneOffset = start.offset,
endTime = end.toInstant(),
endZoneOffset = end.offset,
exerciseType = ExerciseSessionRecord.EXERCISE_TYPE_RUNNING,
title = "My Run #${Random.nextInt(0, 60)}"
),
StepsRecord(
startTime = start.toInstant(),
startZoneOffset = start.offset,
endTime = end.toInstant(),
endZoneOffset = end.offset,
count = (1000 + 1000 * Random.nextInt(3)).toLong()
),
TotalCaloriesBurnedRecord(
startTime = start.toInstant(),
startZoneOffset = start.offset,
endTime = end.toInstant(),
endZoneOffset = end.offset,
energy = Energy.calories((140 + Random.nextInt(20)) * 0.01)
)
) + buildHeartRateSeries(start, end)
)
}
/**
* TODO: Build [HeartRateRecord].
*/
private fun buildHeartRateSeries(
sessionStartTime: ZonedDateTime,
sessionEndTime: ZonedDateTime,
): HeartRateRecord {
val samples = mutableListOf<HeartRateRecord.Sample>()
var time = sessionStartTime
while (time.isBefore(sessionEndTime)) {
samples.add(
HeartRateRecord.Sample(
time = time.toInstant(),
beatsPerMinute = (80 + Random.nextInt(80)).toLong()
)
)
time = time.plusSeconds(30)
}
return HeartRateRecord(
startTime = sessionStartTime.toInstant(),
startZoneOffset = sessionStartTime.offset,
endTime = sessionEndTime.toInstant(),
endZoneOffset = sessionEndTime.offset,
samples = samples
)
}
5. ヘルスコネクト ツールボックス
ヘルスコネクト ツールボックスの概要
ヘルスコネクト ツールボックスは、アプリとヘルスコネクトの統合をテストできるコンパニオン デベロッパー ツールです。ヘルスコネクトに対してデータの読み取りや書き込みを直接行えるほか、アプリの CRUD 操作を簡単にテストできます。
この Codelab では、ヘルスコネクト ツールボックスを使用して、先ほど実装した読み取りと書き込みの機能をテストします。
ヘルスコネクト ツールボックスをセットアップする
ZIP フォルダを展開して APK ファイルを取得します。次に Toolbox APK を接続済みのデバイスにインストールするため、adb
を使用します。APK があるフォルダに移動し、次のコマンドを実行します。
$ adb install HealthConnectToolbox-{Version Number}.apk
ヘルスコネクト ツールボックス アプリを初めて開くと、[App] > [Special app access] > [Display over other apps] の権限設定が表示されます。この権限で、ヘルスコネクト ツールボックスが他のアプリの上にオーバーレイを表示できるようになるため、開発中のアプリから離れることなく、データの読み取りと書き込みをテストできます。
テスト用の読み取りと書き込みの権限を管理するには、ツールボックス アプリのメイン画面からか、権限フローに直接移動してヘルスコネクト アプリを開きます。
健康に関するレコードの読み取りと書き込みを行う
ヘルスコネクト ツールボックスは、ヘルスコネクトのすべてのデータ型の読み取りと書き込みをサポートしています。この Codelab の最後のセッションでは、体重とエクササイズ セッションのレコードをヘルスコネクトに書き込みました。ヘルスコネクト ツールボックスからデータを読み取れるかどうかを確認しましょう。
ヘルスコネクトに対して読み取りや書き込みを行う前に、ユーザーから権限を取得する必要があります。ヘルスコネクト ツールボックスについても同様です。まず、ヘルスコネクト ツールボックスからの権限リクエストを受け入れます。次に、オーバーレイ メニューの検索アイコン をクリックしてダイアログを開き、データ型(体重など)を選択して [READ HEALTH RECORD] ボタンをクリックします。ヘルスコネクトに先ほど書き込んだ Codelab サンプルアプリのレコードが表示されます。
ヘルスコネクトにレコードを挿入するには、オーバーレイ メニューから編集アイコン をクリックしてダイアログを開きます。次に、データ型を選択します。ツールボックスから体重レコードを挿入してみましょう。次のセッションでは、Health Connect API 経由でレコードを読み取り、アプリにデータを表示する方法について説明します。
6. データを読み取る
これで、Codelab サンプルアプリとツールボックス アプリの両方で、体重とエクササイズ セッションのレコードを書き込めました。Health Connect API を使用してこれらのレコードを読み取りましょう。まず ReadRecordsRequest
を作成し、読み取るレコードタイプと期間を指定します。ReadRecordsRequest
で、dataOriginFilter
を設定して、読み取り元のレコードのソースアプリを指定することもできます。
/**
* TODO: Reads in existing [WeightRecord]s.
*/
suspend fun readWeightInputs(start: Instant, end: Instant): List<WeightRecord> {
val request = ReadRecordsRequest(
recordType = WeightRecord::class,
timeRangeFilter = TimeRangeFilter.between(start, end)
)
val response = healthConnectClient.readRecords(request)
return response.records
}
/**
* TODO: Obtains a list of [ExerciseSessionRecord]s in a specified time frame.
*/
suspend fun readExerciseSessions(start: Instant, end: Instant): List<ExerciseSessionRecord> {
val request = ReadRecordsRequest(
recordType = ExerciseSessionRecord::class,
timeRangeFilter = TimeRangeFilter.between(start, end)
)
val response = healthConnectClient.readRecords(request)
return response.records
}
アプリを実行して、体重のレコードとエクササイズ セッションのリストが表示されるかどうかを確認しましょう。
7. 差分データを読み取る
ヘルスコネクトの Differential Changes API は、一連のデータ型について、特定の時点からの変更を追跡するのに役立ちます。たとえば、ユーザーがアプリの外部で既存のレコードを更新または削除したかどうかを把握し、それに応じてデータベースを更新できます。
ヘルスコネクトでのデータの読み取りは、フォアグラウンドで実行されているアプリに制限されています。この制限は、ユーザーのプライバシー保護を強化するために設けられたものです。ヘルスコネクトにはデータのバックグラウンドでの読み取りアクセス権がなく、データの読み取りとアクセスはフォアグラウンドでのみ行えることがユーザーに通知され、保証されます。アプリがフォアグラウンドにあるとき、Differential Changes API を使用すると、デベロッパーは変更トークンをデプロイして、ヘルスコネクトに加えられた変更を取得できます。
HealthConnectManager.kt
には getChangesToken()
と getChanges()
の 2 つの関数があります。これらの関数に Differential Changes API を追加して、データの変更を取得します。
最初の変更トークンの設定
ヘルスコネクトからデータの変更が取得されるのは、アプリが変更トークンでリクエストした場合のみです。変更トークンは、差分データの取得元となる commit 履歴内のポイントを表します。
変更トークンを取得するには、データの変更を追跡する一連のデータ型を指定して ChangesTokenRequest
を送信します。このトークンを保管しておき、ヘルスコネクトから更新を取得するときに使用します。
/**
* TODO: Obtains a Changes token for the specified record types.
*/
suspend fun getChangesToken(): String {
return healthConnectClient.getChangesToken(
ChangesTokenRequest(
setOf(
ExerciseSessionRecord::class,
StepsRecord::class,
TotalCaloriesBurnedRecord::class,
HeartRateRecord::class,
WeightRecord::class
)
)
)
}
変更トークンによるデータ更新
アプリがヘルスコネクトと最後に同期されたときからの変更を取得するには、以前に取得した変更トークンを使用し、そのトークンを含む getChanges
呼び出しを送信します。ChangesResponse
は、ヘルスコネクトで検出された変更(UpsertionChange
や DeletionChange
など)のリストを返します。
/**
* TODO: Retrieve changes from a Changes token.
*/
suspend fun getChanges(token: String): Flow<ChangesMessage> = flow {
var nextChangesToken = token
do {
val response = healthConnectClient.getChanges(nextChangesToken)
if (response.changesTokenExpired) {
throw IOException("Changes token has expired")
}
emit(ChangesMessage.ChangeList(response.changes))
nextChangesToken = response.nextChangesToken
} while (response.hasMore)
emit(ChangesMessage.NoMoreChanges(nextChangesToken))
}
次に、アプリを実行し、[Changes] 画面に移動します。まず、[Track changes] を有効にして、変更トークンを取得します。次に、ツールボックスまたは Codelab アプリから、体重またはエクササイズ セッションを挿入します。[Changes] 画面に戻り、[Get new changes] を選択します。アップサートの変更が表示されます。
8. データを集計する
ヘルスコネクトは、集計 API を介して集計データも提供します。次の例は、ヘルスコネクトから累積データと統計データを取得する方法を示しています。
healthConnectClient.aggregate
を使用して AggregateRequest
を送信します。集計リクエストで、一連の集計指標と取得する時間範囲を指定します。たとえば、ExerciseSessionRecord.EXERCISE_DURATION_TOTAL
と StepsRecord.COUNT_TOTAL
は累積データ、WeightRecord.WEIGHT_AVG
、HeartRateRecord.BPM_MAX
、HeartRateRecord.BPM_MIN
は統計データを提供します。
/**
* TODO: Returns the weekly average of [WeightRecord]s.
*/
suspend fun computeWeeklyAverage(start: Instant, end: Instant): Mass? {
val request = AggregateRequest(
metrics = setOf(WeightRecord.WEIGHT_AVG),
timeRangeFilter = TimeRangeFilter.between(start, end)
)
val response = healthConnectClient.aggregate(request)
return response[WeightRecord.WEIGHT_AVG]
}
この例では、特定のエクササイズ セッションの関連集計データを取得する方法を示します。まず、uid
で healthConnectClient.readRecord
を使用してレコードを読み取ります。次に、エクササイズ セッションの startTime
と endTime
を時間範囲、dataOrigin
をフィルタとして使用し、関連集計データを読み取ります。
/**
* TODO: Reads aggregated data and raw data for selected data types, for a given [ExerciseSessionRecord].
*/
suspend fun readAssociatedSessionData(
uid: String,
): ExerciseSessionData {
val exerciseSession = healthConnectClient.readRecord(ExerciseSessionRecord::class, uid)
// Use the start time and end time from the session, for reading raw and aggregate data.
val timeRangeFilter = TimeRangeFilter.between(
startTime = exerciseSession.record.startTime,
endTime = exerciseSession.record.endTime
)
val aggregateDataTypes = setOf(
ExerciseSessionRecord.EXERCISE_DURATION_TOTAL,
StepsRecord.COUNT_TOTAL,
TotalCaloriesBurnedRecord.ENERGY_TOTAL,
HeartRateRecord.BPM_AVG,
HeartRateRecord.BPM_MAX,
HeartRateRecord.BPM_MIN,
)
// Limit the data read to just the application that wrote the session. This may or may not
// be desirable depending on the use case: In some cases, it may be useful to combine with
// data written by other apps.
val dataOriginFilter = setOf(exerciseSession.record.metadata.dataOrigin)
val aggregateRequest = AggregateRequest(
metrics = aggregateDataTypes,
timeRangeFilter = timeRangeFilter,
dataOriginFilter = dataOriginFilter
)
val aggregateData = healthConnectClient.aggregate(aggregateRequest)
val heartRateData = readData<HeartRateRecord>(timeRangeFilter, dataOriginFilter)
return ExerciseSessionData(
uid = uid,
totalActiveTime = aggregateData[ExerciseSessionRecord.EXERCISE_DURATION_TOTAL],
totalSteps = aggregateData[StepsRecord.COUNT_TOTAL],
totalEnergyBurned = aggregateData[TotalCaloriesBurnedRecord.ENERGY_TOTAL],
minHeartRate = aggregateData[HeartRateRecord.BPM_MIN],
maxHeartRate = aggregateData[HeartRateRecord.BPM_MAX],
avgHeartRate = aggregateData[HeartRateRecord.BPM_AVG],
heartRateSeries = heartRateData,
)
}
次に、アプリを実行して、[Record weight] 画面に平均体重が表示されるかどうかを確認します。また、エクササイズ セッションの詳細なデータを表示するには、[Exercise sessions] 画面を開き、エクササイズ セッションのレコードのいずれかを選択します。
9. 完了
これで、ヘルスコネクトと統合された健康&フィットネス アプリを初めて構築できました。
アプリは、権限を宣言し、アプリで使用されているデータ型に関するユーザー権限をリクエストできます。ヘルスコネクトのデータ ストレージに対して、データの読み取りと書き込みを行うこともできます。また、ヘルスコネクト ツールボックスを使用して、ヘルスコネクトのデータ ストレージにモックデータを作成し、アプリ開発をサポートする方法も学びました。
これで、健康&フィットネス アプリをヘルスコネクト エコシステムに組み込むために必要な主な手順を学習できました。