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:

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

Attention :L'API Sensors ne stocke pas automatiquement les relevés des capteurs dans le magasin de remise en forme, et les enregistrements de capteurs créés avec l'API Sensors ne sont pas conservés lorsque le système redémarre. Il est courant d'utiliser l'API Recording pour enregistrer des données en arrière-plan avec des abonnements persistants. L'API Sensors vous permet d'afficher ou de 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 Google Fit sur les données utilisateur et pour les développeurs.

Lister 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. Ces informations sont utiles pour faire la distinction entre les capteurs similaires sur différents appareils, pour présenter à l'utilisateur les informations provenant d'un capteur ou pour traiter les données différemment en fonction de l'appareil. Par exemple, vous pouvez être intéressé par la lecture des données provenant spécifiquement du capteur d'un accessoire connecté, mais pas par le 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. Cela est utile lorsque vous souhaitez vérifier si une source de données se trouve 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 les données brutes d'un type de données de remise en forme particulier ou 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."));