مراجعة وظيفة Health Connect

توضِّح هذه الصفحة الوظائف الرئيسية لواجهة برمجة التطبيقات Health Connect API.

عمليات CRUD على السجلّات ومزامنتها

توفّر المنصة وظائف إدراج وتعديل وحذف عادية للبيانات المسجّلة. يتضمّن Health Connect أيضًا وظائف تتيح للتطبيقات العميلة مزامنة البيانات خارج Health Connect. يؤدي ذلك إلى إنشاء سجلّ لتغييرات البيانات الذي يعرض للمطوّر والمستخدم ما إذا كانت تطبيقات أخرى قد أدخَلت أو حذفت أنواع بيانات معيّنة.

دوال التجميع الأساسية

يمكن للعملاء تطبيق دالة تجميع على البيانات الأساسية، ما يوفر ما يلي:

  • متوسط القيم أو الحد الأدنى أو الحد الأقصى (على سبيل المثال، الحد الأدنى والأقصى لمعدّل نبضات القلب أثناء جلسة نشاط)
  • المجموع الإجمالي (على سبيل المثال، إجمالي عدد الخطوات في فاصل زمني يومي)
  • عدد بسيط لعدد القياسات الأساسية (مثل عدد جلسات النشاط في أسبوع معيّن)
  • إجمالي المدة لأنواع البيانات المتوافقة (على سبيل المثال، الوقت الذي قضيته في النوم العميق هذا الأسبوع أو إجمالي مدة جلسات النشاط اليوم)

عمليات التحقّق من مدى التوفّر

يتوافق Health Connect مع الإصدار 28 (Pie) من حزمة تطوير البرامج (SDK) لنظام التشغيل Android والإصدارات الأحدث. تسمح حزمة تطوير البرامج (SDK) لتطبيقات العميل بتحديد ما إذا كانت واجهة برمجة التطبيقات Health Connect API مفعّلة على جهاز Android الخاص بالمستخدم. وإذا لم يكن كذلك، يبدأ Health Connect عملية التحقّق من مدى التوفّر لتحديد ما إذا كان جهاز المستخدم متوافقًا.

عمليات التحقّق من الأذونات

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

القراءة باستخدام Health Connect

القراءة في المقدّمة

يمكنك عادةً قراءة البيانات من Health Connect عندما يكون تطبيقك في المقدّمة. في هذه الحالات، يمكنك استخدام خدمة تعمل في المقدّمة لتشغيل هذه العملية في حال وضع المستخدم أو النظام تطبيقك في الخلفية أثناء عملية القراءة.

في الحالات التي قد يتوقّع فيها تطبيقك حدوث انقطاع، مثل عرض قراءة في تطبيقك، يمكنك القراءة مباشرةً من Health Connect إلى تطبيق العميل.

في الحالات التي تفضّل فيها تشغيل تطبيقك بدون انقطاع، استخدِم خدمة تعمل في المقدّمة:

  • FOREGROUND_SERVICE_TYPE_HEALTH: يسمح هذا الإذن للتطبيق بالبقاء في المقدّمة لجمع بيانات أجهزة الاستشعار، مثل تطبيق التمارين الرياضية الذي يواصل جمع البيانات حتى عندما يضع المستخدم التطبيق في الخلفية.

  • FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: خدمة من النوع العام تسمح للتطبيق بمواصلة جمع البيانات المهمة ل tasks التي تستغرق أقل من ثلاث دقائق، حتى إذا وضع المستخدم التطبيق في الخلفية قبل اكتمالها.

القراءة في الخلفية

يمكنك طلب تشغيل تطبيقك في الخلفية وقراءة البيانات من Health Connect. إذا طلبت إذن قراءة البيانات في الخلفية، يمكن للمستخدم منح تطبيقك إذن الوصول إلى البيانات في الخلفية.