모바일용 Recording API

모바일의 Recording API를 사용하면 앱이 배터리 효율적인 방식으로 휴대기기의 걸음 수를 기록할 수 있습니다. 이 API는 계정이 없습니다. 즉, Google 계정이 없어도 서비스를 사용할 수 있으며 데이터는 기기에 저장됩니다.

이 가이드에서는 건강 및 피트니스 환경에서 모바일의 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")
}

그루비 DSL

apply plugin: 'com.android.application'

...

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

권한 요청

모바일에서 Recording API를 사용하여 데이터를 기록하려면 앱에서 다음 권한을 요청해야 합니다.

  • android.permission.ACTIVITY_RECOGNITION

피트니스 데이터 구독

걸음 수, 이동 거리 또는 칼로리 데이터의 백그라운드 수집을 요청하려면 다음 코드 스니펫과 같이 subscribe 메서드를 사용하세요.

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

피트니스 데이터 읽기 및 처리

구독이 완료되면 readData 메서드를 사용하여 데이터를 요청합니다. 그런 다음, 다음 코드 스니펫과 같이 DataReadRequest를 만들어 결과 DataSet에서 DataPoint를 가져올 수 있습니다.

val endTime = LocalDateTime.now().atZone(ZoneId.systemDefault())
val startTime = endTime.minusWeeks(1)
val readRequest =
  DataReadRequest.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(DataType.AGGREGATE_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: DataSet) {
  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.getStartTimeString()}")
    Log.i(TAG,"\tEnd: ${dp.getEndTimeString()}")
    for (field in dp.dataType.fields) {
      Log.i(TAG,"\tField: ${field.name.toString()} Value: ${dp.getValue(field)}")
    }
  }
}

LocalRecordingClient는 데이터 수집을 지속적으로 업데이트합니다. readData를 사용하면 언제든지 최신 수치를 가져올 수 있습니다.

LocalRecordingClient는 최대 10일간의 데이터를 저장합니다. 데이터 손실 위험을 줄이기 위해 WorkManager를 사용하여 백그라운드에서 데이터를 주기적으로 수집할 수 있습니다.

피트니스 데이터 수신 거부

리소스를 확보하려면 앱에서 더 이상 센서 데이터를 필요로 하지 않을 때 센서 데이터 수집을 구독 취소해야 합니다. 구독을 취소하려면 unsubscribe 메서드를 사용합니다.

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