Accesso 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:

• Elenca le origini dati disponibili sul dispositivo e sui dispositivi associati.
• Registra i listener per ricevere dati non elaborati dei sensori.
• Annulla la registrazione dei listener in modo che non ricevano più dati non elaborati dei sensori.

Attenzione: l'API Sensors non archivia automaticamente le letture dei sensori nel Fitness Store e le registrazioni dei sensori create con l'API Sensors non vengono mantenute al riavvio del sistema. In genere, l'API Recording viene utilizzato per registrare dati in background con abbonamenti permanenti; utilizza 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 relative ai dati utente e agli sviluppatori di Google Fit.

Elenco delle origini dati disponibili

Per ottenere un elenco di tutte le origini dati disponibili sul dispositivo e sui dispositivi associati, 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 del 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 a seconda del dispositivo. Ad esempio, potrebbe interessarti leggere i dati specificamente del sensore su un dispositivo indossabile, ma non dello 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 si trova sullo stesso dispositivo su cui viene eseguita l'app.

Aggiungi un listener

Per aggiungere un listener che riceva dati non elaborati di un determinato tipo di dati sull'attività fisica o da un'origine dati specifica, 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()));
}

Rimuovi un listener

Per rimuovere un listener dagli 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."));