إتاحة أدوات استشعار إضافية

أجهزة اللياقة البدنية التي تستخدم البلوتوث منخفض الطاقة 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
    }
}