توضِّح هذه الصفحة الوظائف الرئيسية لواجهة برمجة التطبيقات 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 إلى تطبيق العميل.
في الحالات التي قد تفضّل فيها تشغيل تطبيقك بدون انقطاع، مثل قراءة مجموعة من البيانات من Health Connect ثم كتابة وتحميلها في مكان آخر، استخدِم ForegroundService بدلاً من Activity الذي يمكن إغلاقه بسهولة.
القراءة في الخلفية
يمكنك طلب تشغيل تطبيقك في الخلفية وقراءة البيانات من Health Connect. إذا طلبت إذن قراءة البيانات في الخلفية، يمكن للمستخدم منح تطبيقك إذن الوصول إلى البيانات في الخلفية.