توضّح هذه الصفحة الوظائف الرئيسية لواجهة برمجة التطبيقات Health Connect.
عمليات الإنشاء والقراءة والتعديل والحذف على السجلّ ومزامنة البيانات
توفّر المنصة وظائف الإدراج والتعديل والحذف العادية للبيانات المسجّلة. يتضمّن Health Connect أيضًا وظيفة تتيح للتطبيقات العميلة مزامنة البيانات خارج Health Connect. ويؤدي ذلك إلى إنشاء سجلّ بتغييرات البيانات يوضّح للمطوّر والمستخدم ما إذا كانت تطبيقات أخرى قد أدرجت أنواعًا معيّنة من البيانات أو حذفتها.
دوال التجميع الأساسية
يمكن للعملاء تطبيق دالة تجميع على البيانات الأساسية، ما يوفّر ما يلي:
- قيم المتوسط أو الحد الأدنى أو الحد الأقصى (على سبيل المثال، الحد الأدنى والأقصى لمعدّل نبضات القلب أثناء جلسة نشاط)
- المجموع الكلي (على سبيل المثال، إجمالي عدد الخطوات في فترة يومية)
- عدد بسيط لعدد القياسات الأساسية (على سبيل المثال، عدد جلسات النشاط في أسبوع معيّن)
- المدة الإجمالية لأنواع البيانات المتوافقة (على سبيل المثال، الوقت الذي قضيته في النوم العميق هذا الأسبوع، أو المدة الإجمالية لجلسات النشاط اليوم).
عمليات التحقّق من التوفّر
يتوافق تطبيق Health Connect مع الإصدار 28 (Pie) والإصدارات الأحدث من حزمة تطوير البرامج (SDK) لنظام التشغيل Android. تسمح حزمة SDK لتطبيقات العميل بتحديد ما إذا كانت واجهة برمجة التطبيقات Health Connect مفعّلة على جهاز المستخدم الذي يعمل بنظام التشغيل Android. إذا لم يكن كذلك، سيُطلق تطبيق Health Connect عملية التحقّق من التوافق لتحديد ما إذا كان جهاز المستخدم متوافقًا.
عمليات التحقّق من الأذونات
يتطلّب Health Connect أن تطلب إذن المستخدم لقراءة بيانات الصحة واللياقة البدنية وتعديلها على أساس كل تطبيق على حدة. ويتيح لك أيضًا معرفة الأذونات التي منحها المستخدم أو رفضها.
القراءة باستخدام Health Connect
القراءة في المقدّمة
يمكنك عادةً قراءة البيانات من Health Connect عندما يكون تطبيقك في المقدّمة. في هذه الحالات، يمكنك استخدام خدمة تعمل في المقدّمة لتنفيذ هذه العملية إذا وضع المستخدم أو النظام تطبيقك في الخلفية أثناء عملية القراءة.
في الحالات التي قد يتوقّع فيها تطبيقك حدوث انقطاع، مثل عرض قراءة في تطبيقك، يمكنك القراءة مباشرةً من Health Connect إلى تطبيق العميل.
في الحالات التي تفضّل فيها تشغيل تطبيقك بدون انقطاع، استخدِم خدمة تعمل في المقدّمة:
FOREGROUND_SERVICE_TYPE_HEALTH: يسمح هذا الإذن للتطبيق بالبقاء في المقدّمة لجمع بيانات أجهزة الاستشعار، مثل تطبيق تمارين رياضية يواصل جمع البيانات حتى عندما يضع المستخدم التطبيق في الخلفية.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: خدمة من النوع العام تسمح لأحد التطبيقات بمواصلة جمع البيانات المهمة لإكمال المهام التي تستغرق أقل من ثلاث دقائق، حتى إذا وضع المستخدم التطبيق في الخلفية قبل اكتمالها.
القراءة في الخلفية
يمكنك طلب تشغيل تطبيقك في الخلفية وقراءة البيانات من Health Connect. إذا طلبت الإذن القراءة في الخلفية، يمكن للمستخدم منح تطبيقك الإذن بقراءة البيانات في الخلفية.