תמיכה בחיישנים נוספים

מכשירי כושר עם פרופיל Bluetooth Low Energy GATT נתמכים באופן אוטומטי על ידי Google Fit. אם במכשיר לא מוטמע אחד מהפרופילים האלה, אפשר ליצור אפליקציה ל-Android שמנהלת את התקשורת עם מכשיר הכושר וחושפת אותה ל-Google Fit כחיישן תוכנה. תוכלו גם לחשוף חיישני תוכנה מותאמים אישית באפליקציה.

כדי ליצור חיישן תוכנה באפליקציה, צריך להרחיב את המחלקה FitnessSensorService ולהצהיר עליו כשירות בקובץ המניפסט. כשמשתמשים מתקינים את האפליקציה, Google Fit הופך את חיישני התוכנה לזמינים לאפליקציות אחרות. כשאפליקציה נרשמת לקבלת נתונים מחיישן תוכנה באפליקציה, Google Fit מקשרת לשירות.

הערה: לשיטות מומלצות לניהול נתוני משתמשים, כדאי לעיין במדיניות למפתחים של Google Fit בנושא נתוני משתמשים.

הצהרה על שירות חיישן

כדי להגדיר חיישן תוכנה, מצהירים על הערך 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>

השירות בדוגמה זו פועל בתהליך נפרד, כפי שצוין במאפיין android:process. מידע נוסף זמין במאמר תהליכים.

הטמעת שירות חיישנים

כדי להטמיע חיישן תוכנה, מרחיבים את המחלקה FitnessSensorService ומיישמים את השיטות המופשטות שלו. פרטי ההטמעה משתנים בהתאם לתרחיש השימוש הספציפי שלכם, אבל הדוגמה הבאה כוללת הנחיות כלליות:

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