Recording API を使用してフィットネス データを記録する

モバイル版 Recording API を使用すると、アプリはバッテリー効率の良い方法でモバイル デバイスからフィットネス データを記録できます。たとえば、この API を使用して、歩数計が歩数データを取得するのと同じように、歩数を記録します。この API はアカウントレスです。つまり、サービスを使用するために Google アカウントは必要なく、データはデバイスに保存されます。

アプリで、デバイス上の歩数に加えて、さまざまなソースから他の健康とフィットネスのデータを読み取る必要がある場合は、ヘルスコネクトとの統合が適しています。ヘルスコネクトは、Android 14（API レベル 34）以降でデバイス上の歩数 にネイティブにアクセスすることもできます。

このガイドでは、健康とフィットネスの機能でモバイル版 Recording API を使用する方法について説明します。

例については、GitHub のモバイル版 Recording API のサンプルをご覧ください 。

重要なポイント

モバイル版 Recording API には、次のような独自の注目すべき機能がいくつかあります。

  • 記録サブスクリプションが開始または更新されると、最新のサブスクリプション以降のデータ（最大 10 日間）にアクセスできます。
  • データは、有効なサブスクリプションがある場合にのみ使用できます。unsubscribe を呼び出してサブスクリプションを削除すると、収集されたデータにアクセスできなくなります。

データ型

モバイル版 Recording API は、次のデータ型を記録できます。

使ってみる

まず、build.gradle ファイルに次の依存関係を追加します。

Kotlin DSL

plugin {
  id("com.android.application")
}

...

dependencies {
  implementation("com.google.android.gms:play-services-fitness:21.2.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
  implementation 'com.google.android.gms:play-services-fitness:21.2.0'
}

権限をリクエストする

モバイル版 Recording API を使用してデータを記録するには、アプリで次の権限をリクエスト する必要があります。

  • android.permission.ACTIVITY_RECOGNITION

Google Play 開発者サービスのバージョンを確認する

モバイル版 Recording API を使用するには、Google Play 開発者サービスを LOCAL_RECORDING_CLIENT_MIN_VERSION_CODE に更新する必要があります。これは、 を使用して isGooglePlayServicesAvailable メソッドで確認できます。

val hasMinPlayServices = isGooglePlayServicesAvailable(context, LocalRecordingClient.LOCAL_RECORDING_CLIENT_MIN_VERSION_CODE)

if(hasMinPlayServices != ConnectionResult.SUCCESS) {
  // Prompt user to update their device's Google Play services app and return
}

// Continue with Recording API functions

ユーザーの Google Play 開発者サービスのバージョンが古すぎる場合は、システム ConnectionResult.SERVICE_VERSION_UPDATE_REQUIRED 例外がスローされます。

フィットネス データを登録する

歩数データのバックグラウンド収集をリクエストするには、次のコード スニペットに示すように、subscribe メソッドを使用します。

val localRecordingClient = FitnessLocal.getLocalRecordingClient(this)
// Subscribe to steps data
localRecordingClient.subscribe(LocalDataType.TYPE_STEP_COUNT_DELTA)
  .addOnSuccessListener {
    Log.i(TAG, "Successfully subscribed!")
  }
  .addOnFailureListener { e ->
    Log.w(TAG, "There was a problem subscribing.", e)
  }

フィットネス データを読み取って処理する

登録したら、readData メソッドを使用してデータをリクエストします。次に、結果の LocalDataSet から LocalDataPoints を取得できます。これには、次のコード スニペットに示すように、LocalDataReadRequest を作成します。

val endTime = LocalDateTime.now().atZone(ZoneId.systemDefault())
val startTime = endTime.minusWeeks(1)
val readRequest =
  LocalDataReadRequest.Builder()
    // The data request can specify multiple data types to return,
    // effectively combining multiple data queries into one call.
    // This example demonstrates aggregating only one data type.
    .aggregate(LocalDataType.TYPE_STEP_COUNT_DELTA)
    // Analogous to a "Group By" in SQL, defines how data should be
    // aggregated. bucketByTime allows bucketing by time span.
    .bucketByTime(1, TimeUnit.DAYS)
    .setTimeRange(startTime.toEpochSecond(), endTime.toEpochSecond(), TimeUnit.SECONDS)
    .build()

  localRecordingClient.readData(readRequest).addOnSuccessListener { response ->
    // The aggregate query puts datasets into buckets, so flatten into a
    // single list of datasets.
    for (dataSet in response.buckets.flatMap { it.dataSets }) {
      dumpDataSet(dataSet)
    }
  }
  .addOnFailureListener { e ->
    Log.w(TAG,"There was an error reading data", e)
  }

fun dumpDataSet(dataSet: LocalDataSet) {
  Log.i(TAG, "Data returned for Data type: ${dataSet.dataType.name}")
  for (dp in dataSet.dataPoints) {
    Log.i(TAG,"Data point:")
    Log.i(TAG,"\tType: ${dp.dataType.name}")
    Log.i(TAG,"\tStart: ${dp.getStartTime(TimeUnit.HOURS)}")
    Log.i(TAG,"\tEnd: ${dp.getEndTime(TimeUnit.HOURS)}")
    for (field in dp.dataType.fields) {
      Log.i(TAG,"\tLocalField: ${field.name.toString()} LocalValue: ${dp.getValue(field)}")
    }
  }
}

LocalRecordingClient は、データのコレクションを継続的に更新します。readData を使用すると、いつでも最新の数値を取得できます。

LocalRecordingClient は最大 10 日分のデータを保存します。データが失われるリスクを軽減するには、WorkManager を使用してバックグラウンドでデータを定期的に収集します。

フィットネス データの登録を解除する

リソースを解放するため、アプリでセンサーデータの収集が不要になったら、必ず登録を解除してください。登録を解除するには、unsubscribe メソッドを使用します。

val localRecordingClient = FitnessLocal.getLocalRecordingClient(this)
// Unsubscribe from steps data
localRecordingClient.unsubscribe(LocalDataType.TYPE_STEP_COUNT_DELTA)
  .addOnSuccessListener {
    Log.i(TAG, "Successfully unsubscribed!")
  }
  .addOnFailureListener { e ->
    Log.w(TAG, "There was a problem unsubscribing.", e)
  }