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 les é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 mesures des capteurs dans le les magasins de fitness et les enregistrements de capteurs créés avec l'API Sensors. conservées lors du redémarrage du système. Il est courant d'utiliser l'API Recording pour enregistrer des données en arrière-plan avec Abonnements persistants utiliser l'API Sensors pour afficher ou traiter les capteurs les relevés en temps réel. Bien souvent, ces deux API doivent être utilisées app.

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

Lister les sources de données disponibles

Obtenir la liste de toutes les sources de données disponibles sur l'appareil et sur l'application associée appareils, utilisez la SensorsClient.findDataSources méthode:

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 en vue d'une source de données, utilisez la méthode DataSource.getDevice . Ces informations sont utiles pour distinguer les capteurs de différents appareils, afficher les informations provenant d'un capteur utilisateur ou traiter les données différemment selon l'appareil. Par exemple, vous pouvez lire les données à partir du capteur d'un accessoire connecté d'un appareil, mais pas du même type de capteur sur un téléphone.

Pour obtenir une Device pour l'appareil qui exécute votre activité, utilisez la Device.getLocalDevice . Cela s'avère utile lorsque vous souhaitez vérifier si une source de données se trouve sur sur le même appareil que celui sur lequel votre application s'exécute.

Ajouter un écouteur

Pour ajouter un écouteur afin de recevoir des données brutes d'un type particulier de données de remise en forme une source de données spécifique, utilisez la méthode SensorsClient.add méthode:

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 méthode:

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