Auf Sensor-Rohdaten zugreifen

Mit der Sensors API können Sie die Sensor-Rohdaten in Ihrer App in Echtzeit lesen. Mit dieser API können Sie Folgendes tun:

• Hier werden Datenquellen aufgelistet, die auf dem Gerät und auf Begleitgeräten verfügbar sind.
• Listener registrieren, um Sensor-Rohdaten zu erhalten
• Registrierung von Listenern aufheben, damit sie keine Sensor-Rohdaten mehr erhalten

Achtung :Die Sensors API speichert Sensorwerte nicht automatisch im Fitness-Store und mit der Sensors API erstellte Sensorregistrierungen werden beim Neustart des Systems nicht beibehalten. Im Allgemeinen wird die Recording API verwendet, um Daten im Hintergrund mit dauerhaften Abos aufzuzeichnen. Mit der Sensors API werden Sensormesswerte in Echtzeit angezeigt oder verarbeitet. In vielen Fällen müssen beide APIs in einer App verwendet werden.

Hinweis: Best Practices für die Verwaltung von Nutzerdaten finden Sie in der Google Fit-Richtlinie zu Entwickler- und Nutzerdaten.

Verfügbare Datenquellen auflisten

Mit der Methode SensorsClient.findDataSources können Sie eine Liste aller verfügbaren Datenquellen auf dem Gerät und auf den Begleitgeräten abrufen:

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

Verwenden Sie die Methode DataSource.getDevice, um Informationen zum Gerät für eine Datenquelle abzurufen. Die Geräteinformationen sind nützlich, um sich von ähnlichen Sensoren auf verschiedenen Geräten zu unterscheiden, dem Nutzer die Geräteinformationen eines Sensors anzuzeigen oder Daten je nach Gerät unterschiedlich zu verarbeiten. Angenommen, Sie möchten Daten speziell vom Sensor eines Wearable-Geräts ablesen, aber nicht vom Sensor desselben Typs auf einem Smartphone.

Mit der Methode Device.getLocalDevice rufen Sie eine Device-Instanz für das Gerät ab, auf dem Ihre Aktivität ausgeführt wird. Dies ist nützlich, wenn Sie prüfen möchten, ob sich eine Datenquelle auf dem Gerät befindet, auf dem Ihre App ausgeführt wird.

Listener hinzufügen

Wenn Sie einen Listener hinzufügen möchten, um Rohdaten eines bestimmten Fitnessdatentyps oder aus einer bestimmten Datenquelle zu empfangen, verwenden Sie die Methode 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()));
}

Listener entfernen

Verwenden Sie die Methode SensorsClient.remove, um einen Listener aus der Aktualisierung von Rohdaten zu entfernen:

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