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