Accéder aux données brutes des capteurs

L'API Sensors vous permet de lire les données brutes des capteurs dans votre application en temps réel. Utilisez cette API pour effectuer les opérations suivantes:

• Répertoriez les sources de données disponibles sur l'appareil et sur les appareils associés.
• Enregistrez les écouteurs pour recevoir les données brutes des capteurs.
• Désenregistrez les écouteurs afin qu'ils ne reçoivent plus les données brutes des capteurs.

Attention : L'API Sensors n'enregistre pas automatiquement les données de capteurs dans le magasin d'articles de fitness, et les enregistrements créés avec l'API Sensor ne sont pas conservés au redémarrage du système. Il est courant d'utiliser l'API Recording pour enregistrer des données en arrière-plan avec des abonnements persistants. Utilisez l'API Sensors pour afficher ou traiter les relevés de capteurs en temps réel. Dans de nombreux cas, ces deux API doivent être utilisées dans une application.

Remarque : Pour connaître les bonnes pratiques de gestion des données utilisateur, consultez le Règlement concernant les données utilisateur et les développeurs Google Fit.

Répertorier les sources de données disponibles

Pour obtenir la liste de toutes les sources de données disponibles sur l'appareil et sur les appareils associés, utilisez la méthode 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));

Pour obtenir des informations sur l'appareil pour une source de données, utilisez la méthode DataSource.getDevice. Les informations sur l'appareil sont utiles pour distinguer les capteurs similaires sur différents appareils, pour montrer à l'utilisateur les informations sur l'appareil issues d'un capteur ou pour traiter les données différemment selon l'appareil. Par exemple, vous pourriez vouloir lire les données provenant spécifiquement du capteur d'un accessoire connecté, mais pas du même type de capteur sur un téléphone.

Pour obtenir une instance Device pour l'appareil qui exécute votre activité, utilisez la méthode Device.getLocalDevice. Cette information est utile lorsque vous souhaitez vérifier si une source de données est installée sur le même appareil que celui sur lequel votre application est exécutée.

Ajouter un écouteur

Pour ajouter un écouteur afin de recevoir des données brutes d'un type de données de remise en forme particulier ou provenant d'une source de données spécifique, utilisez la méthode 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()));
}

Supprimer un écouteur

Pour supprimer un écouteur des mises à jour de données brutes, utilisez la méthode 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."));