Accedere ai dati non elaborati dei sensori

L'API Sensors ti consente di leggere i dati non elaborati dei sensori nella tua app in tempo reale. Utilizza questa API per effettuare le seguenti operazioni:

• Elenca le origini dati disponibili sul dispositivo e sui dispositivi companion.
• Registra gli ascoltatori per ricevere dati dai sensori non elaborati.
• Annulla la registrazione degli ascoltatori in modo che non ricevano più dati non elaborati del sensore.

Attenzione: l'API Sensors non memorizza automaticamente le letture dei sensori nell'archivio di fitness e le registrazioni dei sensori create con l'API Sensors non vengono mantenute al momento del riavvio del sistema. È normale utilizzare l'API Recording per registrare i dati in background con abbonamenti persistenti; usa l'API Sensors per visualizzare o elaborare le letture dei sensori in tempo reale. In molti casi, entrambe queste API devono essere utilizzate in un'app.

Nota: per le best practice quando gestisci i dati utente, consulta le Norme sui dati utente e per gli sviluppatori di Google Fit.

Elenca origini dati disponibili

Per ottenere un elenco di tutte le origini dati disponibili sul dispositivo e su dispositivi companion, utilizza il metodo 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));

Per ottenere informazioni sul dispositivo per un'origine dati, utilizza il metodo DataSource.getDevice. Le informazioni sul dispositivo sono utili per distinguere i sensori simili su dispositivi diversi, mostrare le informazioni del dispositivo da un sensore all'utente o elaborare i dati in modo diverso in base al dispositivo. Ad esempio, potrebbe essere interessante leggere i dati specificamente dal sensore su un dispositivo indossabile, ma non dallo stesso tipo di sensore su un telefono.

Per ottenere un'istanza Device per il dispositivo su cui viene eseguita la tua attività, utilizza il metodo Device.getLocalDevice. Questo è utile quando vuoi verificare se un'origine dati è sullo stesso dispositivo su cui è in esecuzione la tua app.

Aggiungi un listener

Per aggiungere un listener per ricevere dati non elaborati di un determinato tipo di dati di fitness o da una specifica origine dati, utilizza il metodo 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()));
}

Rimuovere un listener

Per rimuovere un listener da aggiornamenti dei dati non elaborati, utilizza il metodo 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."));