A API Recording em dispositivos móveis permite que o app registre passos de um dispositivo móvel de maneira eficiente em termos de bateria. Essa API não tem contas, o que significa que ela não exige uma Conta do Google para usar o serviço e os dados são armazenados no dispositivo.
Este guia mostra como usar a API Recording em dispositivos móveis nas suas experiências de saúde e condicionamento físico.
Detalhes importantes
Existem vários recursos importantes exclusivos da API Recording para dispositivos móveis:
- Após o início da assinatura de gravação, até 10 dias de dados são armazenados no dispositivo.
- Os dados só ficam disponíveis quando há uma assinatura ativa. Se uma assinatura
for removida chamando
unsubscribe
, os dados de passos coletados não poderão ser acessados.
Tipos de dados
A API Recording em dispositivos móveis pode gravar os seguintes tipos de dados:
Começar
Para começar, adicione a dependência abaixo ao arquivo build.gradle
:
DSL do Kotlin
plugin {
id("com.android.application")
}
...
dependencies {
implementation("com.google.android.gms:play-services-fitness:21.2.0")
}
DSL do Groovy
apply plugin: 'com.android.application'
...
dependencies {
implementation 'com.google.android.gms:play-services-fitness:21.2.0'
}
Solicitar permissões
Para gravar dados usando a API Recording em dispositivos móveis, seu app precisará solicitar a permissão abaixo:
android.permission.ACTIVITY_RECOGNITION
Inscrever-se nos dados de condicionamento físico
Para solicitar a coleta em segundo plano de dados de passos, distância ou calorias, use o
método subscribe
, conforme mostrado no snippet de código abaixo:
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)
}
Ler e processar dados de condicionamento físico
Depois de assinar, solicite os dados usando o método readData
. Em seguida, você pode conseguir DataPoints do DataSet resultante fazendo uma DataReadRequest, conforme mostrado no snippet de código a seguir:
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)}")
}
}
}
O LocalRecordingClient
atualiza continuamente a coleta de dados. Você pode usar readData para extrair os números mais recentes a qualquer momento.
O LocalRecordingClient
armazena até 10 dias de dados. Para reduzir o
risco de perda de dados, você pode usar o WorkManager para coletar os dados periodicamente em
segundo plano.
Cancelar inscrição nos dados de condicionamento físico
Para liberar recursos, cancele a inscrição da
coleta de dados do sensor quando o app não precisar mais deles. Para
cancelar a inscrição, use o método 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)
}