Mobil cihazlardaki Recording API'si, uygulamanızın mobil cihazdan adımları pil tasarrufu sağlayarak kaydetmesine olanak tanır. Hesapsız olan bu API, hizmeti kullanmak için Google Hesabı gerektirmez ve veriler cihazda depolanır.
Bu kılavuzda, sağlık ve fitness deneyimlerinizde mobil cihazlarda Recording API'yi nasıl kullanacağınız gösterilmektedir.
Önemli ayrıntılar
Mobil cihazlarda Kayıt API'sına özgü birkaç önemli özellik vardır:
- Kayıt aboneliği başladığında veya yenilendikten sonra, en son abonelik tarihinden itibaren 10 güne kadar olan verilere erişilebilir.
- Veriler yalnızca etkin bir abonelik olduğunda kullanılabilir. Bir abonelik
unsubscribe
çağırılarak kaldırılırsa toplanan adım verilerine erişilemez.
Veri türleri
Mobil cihazlardaki Recording API'si aşağıdaki veri türlerini kaydedebilir:
Başlayın
Başlamak için build.gradle
dosyanıza aşağıdaki bağımlılığı ekleyin:
Kotlin DSL
plugin {
id("com.android.application")
}
...
dependencies {
implementation("com.google.android.gms:play-services-fitness:21.2.0")
}
Eski DSL
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-fitness:21.2.0'
}
İzin iste
Mobil cihazlarda Recording API'yi kullanarak veri kaydetmek için uygulamanızın aşağıdaki izni istemesi gerekir:
android.permission.ACTIVITY_RECOGNITION
Play Hizmetleri sürüm kontrolü gerçekleştirme
Kayıt API'sini mobil cihazlarda kullanmak için kullanıcının Google Play Hizmetleri'ni LOCAL_RECORDING_CLIENT_MIN_VERSION_CODE
olarak güncellemesi gerekir. Bunu, isGooglePlayServicesAvailable
yöntemini kullanarak kontrol edebilirsiniz:
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
Aksi takdirde, kullanıcının Google Play Hizmetleri sürümü çok düşükse sistem bir ConnectionResult.SERVICE_VERSION_UPDATE_REQUIRED
istisnası atar.
Fitness Verilerine abone ol
Adım, mesafe veya kalori verilerinin arka planda toplanmasını istemek için aşağıdaki kod snippet'inde gösterildiği gibi subscribe
yöntemini kullanın:
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)
}
Fitness Verilerini Okuma ve İşleme
Abone olduktan sonra, readData
yöntemini kullanarak verileri isteyin. Ardından, aşağıdaki kod snippet'inde gösterildiği gibi bir LocalDataReadRequest
oluşturarak elde edilen LocalDataSet
öğesinden LocalDataPoints elde edebilirsiniz:
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
, veri koleksiyonunu sürekli olarak günceller. En güncel rakamları dilediğiniz zaman readData
kullanarak alabilirsiniz.
LocalRecordingClient
en fazla 10 günlük veri depolar. Veri kaybetme riskini azaltmak için WorkManager'ı kullanarak verileri arka planda düzenli aralıklarla toplayabilirsiniz.
Fitness verileri aboneliğinden çık
Kaynaklardan tasarruf etmek için, uygulamanızın artık sensör verisi toplama işlemine ihtiyaç duymadığı durumlarda bu veri toplama aboneliğinin aboneliğinden çıkmanız gerekir. Abonelikten çıkmak için unsubscribe
yöntemini kullanın:
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)
}