دليل نقل البيانات

تضم مجموعة منتجات Google العديد من المنتجات والخدمات الصحية، بما في ذلك Health Connect. تم إيقاف Google Fit Android API نهائيًا وستبقى متاحة حتى نهاية 2024، أي بعد أن يتم إيقافها. توضّح لك الإرشادات التالية واجهة برمجة التطبيقات أو النظام الأساسي المطلوب نقل البيانات إليهما من كل واجهة من واجهات برمجة تطبيقات Google Fit Android API.

واجهة برمجة تطبيقات أداة الاستشعار

تتيح لك Sensor API قراءة بيانات أجهزة الاستشعار الأولية في تطبيقك في الوقت الفعلي. تتولى واجهة برمجة تطبيقات المستشعر إجراء ما يلي:

  • يسرد مصادر البيانات المتاحة على الجهاز وعلى الأجهزة المرتبطة.
  • تسجِّل أدوات الاستشعار لتلقّي بيانات أجهزة الاستشعار الأولية.
  • يؤدي هذا الخيار إلى إلغاء تسجيل أدوات الاستشعار حتى لا تتلقّى بيانات أجهزة الاستشعار الأولية.

نقل البيانات من "واجهة برمجة تطبيقات الاستشعار" إلى واجهات برمجة التطبيقات أو الأنظمة الأساسية التالية:

الهاتف ارتداء الجهاز

استخدام SensorManager, FusedLocationProvider

استخدام "الخدمات الصحية"

  • PassiveMonitoringClient
  • MeasurementClient
  • عميل التمرين

    أو استخدِم SensorManager أو FusedLocationProvider

واجهة برمجة تطبيقات الجلسة

تمثل الجلسات فاصلاً زمنيًا يمارس فيه المستخدمون أحد أنشطة اللياقة البدنية.

تسمح Session API لتطبيقك بإنشاء جلسات في متجر اللياقة البدنية.

نقل البيانات إلى واجهات برمجة التطبيقات أو المنصات التالية من Session API:

الهاتف ارتداء الجهاز

بدء/إيقاف: غير سارٍ. ويجب أن يتتبع التطبيق حالة الجلسات الجارية داخليًا.

القراءة/الكتابة: استخدِم Health Connect.

بدء/إيقاف: استخدام الخدمات الصحية (ExerciseClient)

القراءة/الكتابة: استخدِم Health Connect عبر التطبيق المتوافق مع الأجهزة الجوّالة.

بالنسبة إلى عمليات سير العمل المحدَّدة، ننصح بما يلي:

  • إدراج جلسة: على المطوّرين استخدام Health Connect وإدخال سجلّ ActivitySession أو سجلّ SleepSession وفقًا لذلك.
  • واجهة برمجة تطبيقات التسجيل

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

    نقل البيانات إلى واجهات برمجة التطبيقات أو الأنظمة الأساسية التالية من Reporting API:

    الهاتف ارتداء الجهاز

    اتّبِع الخطوات التالية لنقل البيانات من Reporting API:

    1. استخدام ميزة تسجيل البيانات باستخدام تطبيق SensorManager
    2. اكتب البيانات التي تم تسجيلها في Health Connect.
    3. يمكنك دمج الخطوتَين أ وب عند الضرورة في خدمة تعمل في المقدّمة، على سبيل المثال، عندما تحتاج إلى مواصلة تسجيل البيانات بدون التفاعل مع التطبيق نفسه.

    استخدام "الخدمات الصحية"

    • PassiveMonitoringClient
    • عميل التمرين

      راجع مستندات الخدمات الصحية للحصول على مزيد من المعلومات حول الاختلافات بين PassiveMonitoringClient وExerciseClient.

    History API

    تسمح واجهة برمجة التطبيقات History API لتطبيقك بإجراء عمليات مجمّعة في متجر اللياقة البدنية، بما في ذلك قراءة بيانات الصحة والعافية السابقة وإدراجها وتحديثها وحذفها.

    نقل البيانات إلى واجهات برمجة التطبيقات أو المنصات التالية من History API:

    الهاتف ارتداء الجهاز

    استخدام Health Connect

    استخدِم Health Connect من التطبيق المتوافق مع الأجهزة الجوّالة وليس من الجهاز القابل للارتداء.

    واجهة برمجة تطبيقات الأهداف

    الأهداف هي أهداف في تطبيق Google Fit يمكن للمستخدمين تحديدها لأنفسهم. تساعد في تحفيز المستخدمين للحفاظ على نشاطهم كل يوم. من داخل ملفه الشخصي، يمكن للمستخدمين ضبط عدد الخطوات ونقاط القلب التي يريدون استهدافها يوميًا. يسجّل نظام Google Fit أهدافه ويتتبّع نشاطه اليومي وفقًا لها باستخدام Goals API.

    الهاتف ارتداء الجهاز
    لا تتوفر أي واجهة برمجة تطبيقات بديلة. لا تتوفر أي واجهة برمجة تطبيقات بديلة.

    واجهة برمجة تطبيقات BLE

    يمكن لتطبيقك العثور على أجهزة Bluetooth Low Energy (BLE) المتاحة وإدراج بيانات جهاز الاستشعار في نظام Google Fit الأساسي باستخدام BLE API.

    نقل البيانات إلى واجهات برمجة التطبيقات أو الأنظمة الأساسية التالية من واجهة برمجة التطبيقات BLE API:

    الهاتف ارتداء الجهاز
    يمكنك استخدام واجهات برمجة تطبيقات بلوتوث Android مباشرةً. يمكنك استخدام واجهات برمجة تطبيقات بلوتوث Android مباشرةً.

    نقل البيانات من Fit Android API إلى Health Connect API

    هناك 3 خطوات رئيسية عليك اتّباعها لنقل البيانات إلى Health Connect API.

    الخطوة 1: الدمج

    تتمثّل الخطوة الأولى لعملية الدمج في إضافة Health Connect إلى تطبيقك. وسيتضمّن ذلك ما يلي:

    • يمكنك الدمج مع تطبيق Health Connect باتّباع الخطوات الموضّحة هنا.
    • يجب تحديد أنواع البيانات ووضع الوصول المطلوبَين في بيان التطبيق.
    • يجب الحصول على إذن من المستخدم للوصول إلى Health Connect.
    • قراءة/كتابة البيانات وفقًا لحالات الاستخدام أو مهام سير العمل المحدّدة

    الخطوة 2: نقل البيانات

    ننصحك بإبقاء عمليات الدمج بين Google Fit Android API وHealth Connect API مفعّلة أثناء نقل بيانات المستخدمين من نظام إلى آخر. نحن نهدف إلى إيقاف واجهة برمجة التطبيقات في تطبيق Fit Android نهائيًا، ولكنّنا نسعى إلى إيقافها نهائيًا قبل نهاية عام 2024. يهدف ذلك إلى منح المستخدمين الوقت الكافي للتبديل إلى Health Connect ومواصلة الاستفادة من خدماتهم.

    الخطوة 3: إخلاء مساحة تخزين

    اتّبِع الخطوات التالية لإزالة حزمة تطوير البرامج (SDK) في Fit:

    1. يمكنك إزالة الرمز المرتبط بـ Fit Android API.
    2. أزِل التبعيات.

    يجب أن يعتمد توقيت الإيقاف النهائي لواجهة برمجة التطبيقات Fit Android API على الإحصاءات والتقييمات التي تجريها. يمكنك مواصلة الدمج مع Fit Android API حتى نهاية عام 2024.