휴대기기의 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
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
메서드를 사용하여 데이터를 요청합니다. 그런 다음 아래 코드 스니펫과 같이 LocalDataReadRequest
를 만들어 결과 LocalDataSet
에서 LocalDataPoint를 가져올 수 있습니다.
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)
}