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:

• Enumera 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 sensores en la tienda física y los registros de sensores creados con la API de Sensors no se y persisten cuando se reinicia el sistema. Es común usar API de Recording para registrar datos en segundo plano con las suscripciones persistentes; usar la API de Sensors para mostrar o procesar de lectura en tiempo real. En muchos casos, ambas APIs deben usarse en un app.

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

Enumera las fuentes de datos disponibles

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

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));

Para obtener información acerca del dispositivo para una fuente de datos, usa el DataSource.getDevice . La información del dispositivo es útil para distinguir sensores en diferentes dispositivos, muestra la información del dispositivo desde un sensor al usuario o procesar datos de manera diferente según el dispositivo. Por ejemplo, podrías Le interesa leer datos específicos del sensor de un dispositivo wearable pero no del mismo tipo de sensor en un teléfono.

Para obtener un Device para el dispositivo que está ejecutando tu actividad, usa el Device.getLocalDevice . Esto es útil cuando quieres comprobar si una fuente de datos se encuentra en el mismo dispositivo en el que se ejecuta tu app.

Agrega un objeto de escucha

Para agregar un objeto de escucha que reciba datos sin procesar de un tipo de datos de actividad física en particular o de una fuente de datos específica, usa el SensorsClient.add método:

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 eliminar un objeto de escucha de las actualizaciones de datos sin procesar, usa el SensorsClient.remove método:

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."));