Supporto di sensori aggiuntivi

Dispositivi per il fitness che implementano uno standard Bluetooth Low Energy GATT sono supportati automaticamente da Google Fit. Se il tuo dispositivo non implementa uno di questi profili, puoi creare un'app per Android che gestisce la comunicazione con il dispositivo per il fitness e lo espone a Google Fit come sensore software. Puoi anche esporre software sensori nella tua app.

Per creare un sensore software nella tua app, estendi il FitnessSensorService e la dichiara come servizio nel file manifest. Quando gli utenti installano la tua app, Google Fit rende i tuoi sensori software disponibili per altre app. Quando un'app si registra per ricevere dati da un sensore software nella tua app, Google Fit si lega al tuo servizio.

Nota: per le best practice per la gestione dei dati utente, consulta Norme relative ai dati utente e per gli sviluppatori di Google Fit.

Dichiara un servizio del sensore

Per definire un sensore software, dichiara un FitnessSensorService nel file manifest della tua app:

<service android:name="com.example.MySensorService"
         android:process=":sensor">
  <intent-filter>
    <action android:name="com.google.android.gms.fitness.service.FitnessSensorService" />
    <!-- include at least one mimeType filter for the supported data types -->
    <data android:mimeType="vnd.google.fitness.data_type/com.google.heart_rate.bpm" />
  </intent-filter>
</service>

Il servizio in questo esempio viene eseguito in un processo separato, come specificato dall'attributo android:process. Per ulteriori informazioni, vedi Processi.

Implementare un servizio di sensori

Per implementare un sensore software, estendi la classe FitnessSensorService e a implementare i suoi metodi astratti. I dettagli dell'implementazione dipendono dal tuo caso d'uso specifico, ma l'esempio seguente fornisce linee guida generali:

Kotlin

class MySensorService : FitnessSensorService() {
    override fun onCreate() {
        super.onCreate()
        // 1. Initialize your software sensor(s).
        // 2. Create DataSource representations of your software sensor(s).
        // 3. Initialize some data structure to keep track of a registration
        // for each sensor.
    }

    override fun onFindDataSources(dataTypes: List<DataType>): List<DataSource> {
        // 1. Find which of your software sensors provide the data types requested.
        // 2. Return those as a list of DataSource objects.
    }

    override fun onRegister(request: FitnessSensorServiceRequest): Boolean {
        // 1. Determine which sensor to register with request.dataSource.
        // 2. If a registration for this sensor already exists, replace it with
        //    this one.
        // 3. Keep (or update) a reference to the request object.
        // 4. Configure your sensor according to the request parameters.
        // 5. When the sensor has new data, deliver it to the platform by
        //    calling request.dispatcher.publish(dataPoints)
    }

    override fun onUnregister(dataSource: DataSource): Boolean {
        // 1. Configure this sensor to stop delivering data to the platform
        // 2. Discard the reference to the registration request object
    }
}

Java

public class MySensorService extends FitnessSensorService {
    @Override
    public void onCreate() {
        super.onCreate();
        // 1. Initialize your software sensor(s).
        // 2. Create DataSource representations of your software sensor(s).
        // 3. Initialize some data structure to keep track of a registration
        //    for each sensor.
    }

    @NonNull
    @Override
    public List<DataSource> onFindDataSources(@NonNull List<DataType> list) {
        // 1. Find which of your software sensors provide the data types
        //    requested.
        // 2. Return those as a list of DataSource objects.
    }

    @Override
    public boolean onRegister(
            @NonNull FitnessSensorServiceRequest fitnessSensorServiceRequest) {
        // 1. Determine which sensor to register with request.dataSource.
        // 2. If a registration for this sensor already exists, replace it with
        //    this one.
        // 3. Keep (or update) a reference to the request object.
        // 4. Configure your sensor according to the request parameters.
        // 5. When the sensor has new data, deliver it to the platform by
        //    calling request.getDispatcher.publish(dataPoints);
    }

    @Override
    public boolean onUnregister(@NonNull DataSource dataSource) {
        // 1. Configure this sensor to stop delivering data to the platform
        // 2. Discard the reference to the registration request object
    }
}