Obsługa dodatkowych czujników

Urządzenia do ćwiczeń, które implementują standardowy profil Bluetooth Low Energy GATT, są automatycznie obsługiwane przez Google Fit. Jeśli Twoje urządzenie nie implementuje żadnego z tych profili, możesz utworzyć aplikację na Androida, która zarządza komunikacją z urządzeniem fitnessowym i udostępnia je Google Fit jako czujnika programowego. Możesz też udostępnić niestandardowe oprogramowanie w Twojej aplikacji.

Aby utworzyć w aplikacji czujnik oprogramowania, rozszerzasz klasę FitnessSensorService i deklarujesz ją jako usługę w pliku manifestu. Gdy użytkownicy zainstalują Twoją Google Fit udostępnia czujniki programowe innym aplikacjom. Gdy aplikacja rejestruje się, aby odbierać dane z czujnika programowego, Google Fit połączy się z Twoją usługą.

Uwaga: sprawdzone metody zarządzania danymi użytkowników znajdziesz w artykule Zasady Google Fit dla deweloperów i dotyczące danych użytkownika.

Zadeklarowanie usługi czujnika

Aby zdefiniować czujnik oprogramowania, w pliku manifestu aplikacji zadeklaruj: FitnessSensorService

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

W tym przykładzie usługa działa w ramach osobnego procesu, zgodnie z atrybutem android:process. Więcej informacji: Procesy.

Wdrażanie usługi czujnika

Aby zaimplementować czujnik oprogramowania, rozszerz klasę FitnessSensorService i zaimplementuj jej abstrakcyjne metody. Szczegóły implementacji zależą od konkretnego przypadku użycia, ale w tym przykładzie znajdziesz ogólne wskazówki:

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
    }
}