Acceder a datos de sensores sin procesar

La API de Sensors te permite leer datos de sensores sin procesar en tu app en tiempo real. Usa esta API para hacer lo siguiente:

• Indica las fuentes de datos que están disponibles en el dispositivo y en los dispositivos complementarios.
• Registra objetos de escucha para recibir datos de sensores sin procesar.
• Cancela el registro de los objetos de escucha para que ya no reciban datos de sensores sin procesar.

Precaución: La API de Sensors no almacena automáticamente las lecturas de los sensores en el gimnasio, y los registros de sensores creados con la API de Sensors no se mantienen cuando se reinicia el sistema. Es común usar la API de Recording para registrar datos en segundo plano con suscripciones persistentes; usa la API de Sensors para mostrar o procesar lecturas de sensores en tiempo real. En muchos casos, estas APIs deben usarse en una app.

Nota: Para conocer las prácticas recomendadas para administrar datos del usuario, consulta la Política de Datos del Usuario y del Desarrollador de Google Fit.

Cómo enumerar las fuentes de datos disponibles

Para obtener una lista de todas las fuentes de datos disponibles en el dispositivo y en los dispositivos complementarios, usa el método SensorsClient.findDataSources:

Kotlin

private val fitnessOptions = FitnessOptions.builder().addDataType(DataType.TYPE_STEP_COUNT_DELTA).build()

// Note: Fitness.SensorsApi.findDataSources() requires the
// ACCESS_FINE_LOCATION permission.
Fitness.getSensorsClient(requireContext(), GoogleSignIn.getAccountForExtension(requireContext(), fitnessOptions))
    .findDataSources(
        DataSourcesRequest.Builder()
            .setDataTypes(DataType.TYPE_STEP_COUNT_DELTA)
            .setDataSourceTypes(DataSource.TYPE_RAW)
            .build())
    .addOnSuccessListener { dataSources ->
        dataSources.forEach {
            Log.i(TAG, "Data source found: ${it.streamIdentifier}")
            Log.i(TAG, "Data Source type: ${it.dataType.name}")

            if (it.dataType == DataType.TYPE_STEP_COUNT_DELTA) {
                Log.i(TAG, "Data source for STEP_COUNT_DELTA found!")

                ...
            }
        }
    }
    .addOnFailureListener { e ->
        Log.e(TAG, "Find data sources request failed", e)
    }

Java

FitnessOptions fitnessOptions = FitnessOptions.builder().addDataType(DataType.TYPE_STEP_COUNT_DELTA).build();

// Note: Fitness.SensorsApi.findDataSources() requires the
// ACCESS_FINE_LOCATION permission.
Fitness.getSensorsClient(getApplicationContext(), GoogleSignIn.getAccountForExtension(getApplicationContext(), fitnessOptions))
        .findDataSources(
                new DataSourcesRequest.Builder()
                        .setDataTypes(DataType.TYPE_STEP_COUNT_DELTA)
                        .setDataSourceTypes(DataSource.TYPE_RAW)
                        .build())
        .addOnSuccessListener(dataSources -> {
            dataSources.forEach(dataSource -> {
                Log.i(TAG, "Data source found: ${it.streamIdentifier}");
                Log.i(TAG, "Data Source type: ${it.dataType.name}");

                if (dataSource.getDataType() == DataType.TYPE_STEP_COUNT_DELTA) {
                    Log.i(TAG, "Data source for STEP_COUNT_DELTA found!");
                    ...
                }
            })})
        .addOnFailureListener(e ->
            Log.e(TAG, "Find data sources request failed", e));

Si quieres obtener información sobre el dispositivo para una fuente de datos, usa el método DataSource.getDevice. La información del dispositivo es útil para distinguir sensores similares en distintos dispositivos, mostrar la información de un sensor al usuario o procesar datos de manera diferente según el dispositivo. Por ejemplo, es posible que te interese leer datos específicamente del sensor de un dispositivo wearable, pero no del mismo tipo de sensor en un teléfono.

Para obtener una instancia de Device para el dispositivo que ejecuta tu actividad, usa el método Device.getLocalDevice. Esto resulta útil cuando quieres verificar si una fuente de datos se encuentra en el mismo dispositivo en el que se ejecuta tu app.

Agrega un objeto de escucha

Si deseas agregar un objeto de escucha para recibir datos sin procesar de un tipo de datos de entrenamiento en particular o de una fuente de datos específica, usa el método SensorsClient.add:

Kotlin

val listener = OnDataPointListener { dataPoint ->
        for (field in dataPoint.dataType.fields) {
            val value = dataPoint.getValue(field)
            Log.i(TAG, "Detected DataPoint field: ${field.name}")
            Log.i(TAG, "Detected DataPoint value: $value")
        }
    }

Fitness.getSensorsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    .add(
        SensorRequest.Builder()
            .setDataSource(dataSource) // Optional but recommended for custom
            // data sets.
            .setDataType(dataType) // Can't be omitted.
            .setSamplingRate(10, TimeUnit.SECONDS)
            .build(),
        listener
    )
    .addOnSuccessListener {
    	Log.i(TAG, "Listener registered!")
    }
    .addOnFailureListener {
    	Log.e(TAG, "Listener not registered.", task.exception)
    }

Java

OnDataPointListener listener = dataPoint -> {
    for (Field field : dataPoint.getDataType().getFields()) {
        Value value = dataPoint.getValue(field);
        Log.i(TAG, "Detected DataPoint field: ${field.getName()}");
        Log.i(TAG, "Detected DataPoint value: $value");
    }
};
Fitness.getSensorsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
        .add(
                new SensorRequest.Builder()
                        .setDataSource(dataSource) // Optional but recommended
                        // for custom data sets.
                        .setDataType(dataType) // Can't be omitted.
                        .setSamplingRate(10, TimeUnit.SECONDS)
                        .build(),
                listener
        )
        .addOnSuccessListener(unused ->
                Log.i(TAG, "Listener registered!"))
        .addOnFailureListener(task ->
    Log.e(TAG, "Listener not registered.", task.getCause()));
}

Quita un objeto de escucha

Para quitar un objeto de escucha de las actualizaciones de datos sin procesar, usa el método SensorsClient.remove:

Kotlin

Fitness.getSensorsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    .remove(listener)
    .addOnSuccessListener {
    	Log.i(TAG, "Listener was removed!")
    }
    .addOnFailureListener {
    	Log.i(TAG, "Listener was not removed.")
    }

Java

Fitness.getSensorsClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
        .remove(listener)
        .addOnSuccessListener(unused ->
                Log.i(TAG, "Listener was removed!"))
        .addOnFailureListener(e ->
                Log.i(TAG, "Listener was not removed."));