تسجيل بيانات اللياقة البدنية

تسمح واجهة برمجة تطبيقات التسجيل لتطبيقك بطلب التخزين التلقائي لبيانات جهاز الاستشعار بطريقة فعّالة لاستخدام البطارية من خلال إنشاء الاشتراكات. يرتبط الاشتراك بتطبيق Android ويتكون من نوع من بيانات اللياقة البدنية أو مصدر بيانات محدّد.

يمكنك إنشاء اشتراكات متعددة لأنواع مختلفة من البيانات أو مصادر البيانات في تطبيقك. ويخزِّن Google Fit بيانات اللياقة البدنية الواردة من الاشتراكات النشطة، حتى في حال عدم تشغيل تطبيقك، ويستعيد هذه الاشتراكات عند إعادة تشغيل النظام.

وتتوفر البيانات المسجَّلة في سجلّ اللياقة البدنية للمستخدم. إذا كنت تريد أيضًا عرض البيانات في تطبيقك في الوقت الفعلي، استخدِم Sensors API مع Reporting API. لتسجيل بيانات اللياقة البدنية باستخدام البيانات الوصفية للجلسة، استخدِم Sessions API.

الاشتراك في بيانات اللياقة البدنية

لطلب جمع بيانات جهاز الاستشعار في الخلفية في تطبيقك، استخدِم طريقة RecordingClient.subscribe كما هو موضّح في مقتطف الرمز التالي:

Kotlin

Fitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    // This example shows subscribing to a DataType, across all possible data
    // sources. Alternatively, a specific DataSource can be used.
    .subscribe(DataType.TYPE_STEP_COUNT_DELTA)
    .addOnSuccessListener {
        Log.i(TAG, "Successfully subscribed!")
    }
    .addOnFailureListener { e ->
        Log.w(TAG, "There was a problem subscribing.", e)
    }

Java

Fitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
        // This example shows subscribing to a DataType, across all possible
        // data sources. Alternatively, a specific DataSource can be used.
        .subscribe(DataType.TYPE_STEP_COUNT_DELTA)
        .addOnSuccessListener(unused ->
                Log.i(TAG, "Successfully subscribed!"))
        .addOnFailureListener( e ->
        Log.w(TAG, "There was a problem subscribing.", e));

إذا تمت إضافة الاشتراك بنجاح، سيخزِّن Google Fit بيانات اللياقة البدنية من النوع TYPE_STEP_COUNT_DELTA في سجلّ اللياقة البدنية نيابةً عن تطبيقك. ويظهر هذا الاشتراك في قائمة الاشتراكات النشطة لتطبيقك.

للاشتراك في المزيد من أنواع بيانات اللياقة البدنية في تطبيقك، اتّبع الخطوات الواردة في المثال السابق، ولكن قدِّم نوعًا مختلفًا من بيانات اللياقة البدنية في كل مرة.

إدراج الاشتراكات النشطة

للحصول على قائمة بالاشتراكات النشطة لتطبيقك، استخدِم الإجراء RecordingClient.listSubscriptions كما هو موضّح في مقتطف الرمز التالي:

Kotlin

Fitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    .listSubscriptions()
    .addOnSuccessListener { subscriptions ->
        for (sc in subscriptions) {
            val dt = sc.dataType
            Log.i(TAG, "Active subscription for data type: ${dt.name}")
        }
    }

Java

Fitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
        .listSubscriptions()
        .addOnSuccessListener(subscriptions -> {
            for (Subscription sc : subscriptions) {
                DataType dt = sc.getDataType();
                Log.i(TAG, "Active subscription for data type: ${dt.name}");
            }
    });
}

إلغاء الاشتراك في بيانات اللياقة البدنية

لإيقاف جمع بيانات أداة الاستشعار في تطبيقك، استخدِم طريقة RecordingClient.unsubscribe كما هو موضّح في مقتطف الرمز التالي:

Kotlin

Fitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
    // This example shows unsubscribing from a DataType. A DataSource should
    // be used where the subscription was to a DataSource. Alternatively, if
    // the client doesn't maintain its subscription information, they can use
    // an element from the return value of listSubscriptions(), which is of
    // type Subscription.
    .unsubscribe(DataType.TYPE_STEP_COUNT_DELTA)
    .addOnSuccessListener {
        Log.i(TAG,"Successfully unsubscribed.")
    }
    .addOnFailureListener { e->
        Log.w(TAG, "Failed to unsubscribe.")
        // Retry the unsubscribe request.
    }

Java

Fitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))
        // This example shows unsubscribing from a DataType. A DataSource
        // should be used where the subscription was to a DataSource.
        // Alternatively, if the client doesn’t maintain its subscription
        // information, they can use an element from the return value of
        // listSubscriptions(), which is of type Subscription.
        .unsubscribe(DataType.TYPE_STEP_COUNT_DELTA)
        .addOnSuccessListener(unused ->
            Log.i(TAG,"Successfully unsubscribed."))
        .addOnFailureListener(e -> {
            Log.w(TAG, "Failed to unsubscribe.");
            // Retry the unsubscribe request.
        });
}