يتم تخزين أنواع البيانات في Health Connect في عناصر فرعية من
Record.
لكل نوع بيانات، هناك حقول مرتبطة تكون إما عامة مثل time وzoneOffset، أو محددة مثل title وcount وpercentage.
تستخدم بعض الحقول أنواعًا أساسية، مثل long أو double أو string، بينما تستخدم حقول أخرى أنواعًا معقّدة، مثل التعدادات والفئات، مثل Instant وZoneOffset. يمكن أن تكون سمات هذه الحقول مطلوبة أو اختيارية. بعض السمات للقراءة فقط، وبعضها الآخر محصور بنطاق معيّن من القيم.
للاطّلاع على القائمة الكاملة بأنواع البيانات المتاحة وحقولها، يُرجى الرجوع إلى الفئات في Jetpack.
سمات البيانات الوصفية
تتضمّن البيانات في واجهة برمجة التطبيقات Health Connect API أيضًا سمات البيانات الوصفية الموضّحة في القائمة التالية:
- معرّف Health Connect: يتم تعيين معرّف فريد لكل نقطة بيانات عند إنشائها. ويفيد ذلك في عمليات القراءة والكتابة العادية. يمكنك الاطّلاع على معرّف Health Connect لمزيد من التفاصيل.
- وقت آخر تعديل: يشير هذا الحقل إلى الطابع الزمني لآخر مرة تم فيها تعديل سجل. يتم إنشاؤه تلقائيًا عند إنشاء السجلّ لأول مرة أو عند كل تعديل.
- مصدر البيانات: يخزِّن تطبيق Health Connect معلومات حول التطبيق الذي تم جمع البيانات منه. ويحتوي على اسم حزمة المصدر، والذي تتم إضافته تلقائيًا عند إنشاء المصدر.
- الجهاز: يخزِّن تطبيق Health Connect معلومات حول الجهاز الذي تم جمع البيانات منه. نوع الجهاز هو الحقل الوحيد الإلزامي، أما جميع الحقول الأخرى (الشركة المصنّعة والطراز والاسم المعروض ومعرّف الجهاز الفريد (UDI)) فهي اختيارية.
- معرّف العميل: يوفّر Health Connect معرّفات العملاء لكي تتمكّن تطبيقات العميل من الرجوع إلى البيانات باستخدام معرّفاتها الخاصة، ما يساعد في حل التعارضات ويسهّل عملية المزامنة. يتم توفير هذا المعرّف للسجلّ يدويًا.
- إصدار سجلّ العميل: بالإضافة إلى رقم تعريف العميل، يوفّر Health Connect ميزة تحديد الإصدارات للمساعدة في تتبُّع التغييرات أثناء مزامنة البيانات. ويتم إدخالها في السجلّ يدويًا.
- طريقة التسجيل: يتيح لك تطبيق Health Connect معرفة طريقة تسجيل البيانات. وتشمل هذه الطرق تسجيل التطبيقات للبيانات بشكل غير مباشر (تلقائيًا)، وتسجيل المستخدمين للبيانات بشكل مباشر أو يدوي.
معرّف Health Connect
يُعيّن تطبيق Health Connect معرّفات فريدة (UID) لعناصر البيانات التي تم إدراجها حديثًا، والتي تحدّد عناصر البيانات وتميّزها عن غيرها. تكون معرّفات Health Connect مفيدة في طلبات القراءة أو الكتابة. لا تتطابق أرقام تعريف Health Connect مع أرقام تعريف العملاء. يُحدّد تطبيق العميل أرقام تعريف العملاء، بينما يحدّد Health Connect أرقام تعريف Health Connect حصريًا.
يُرجى مراعاة الملاحظات التالية عند استخدام معرّفات Health Connect:
- تحتوي الجلسات على معرّف واحد في Health Connect، ولكن البيانات داخل الجلسات لها معرّفات خاصة بها في Health Connect.
- لا ترتبط معرّفات Health Connect بالطوابع الزمنية.
- قد تتطلّب بعض حالات الاستخدام تخزين معرّف Health Connect معيّن أثناء سير العمل. على سبيل المثال، يلزم توفّر معرّف محدّد لاسترداد إدخال البيانات الذي سجّله المستخدم وعرضه له.
الوقت في Health Connect
يجب أن تحدّد جميع البيانات التي يتم نقلها إلى Health Connect معلومات إزاحة المنطقة الزمنية. يسمح تحديد إزاحة المنطقة الزمنية للتطبيقات بقراءة البيانات وعرضها بالتوقيت المدني. الوقت المدني هو الوقت المحلي الذي يهم المستخدم، ولكن ليس بالضرورة أن يكون بالتوقيت العالمي المنسَّق (UTC).
في حالات نادرة، قد لا يكون إزاحة المنطقة الزمنية متاحة. عند حدوث ذلك في نظام التشغيل Android 14 (المستوى 34 لواجهة برمجة التطبيقات)، يضبط تطبيق Health Connect الإزاحة الزمنية استنادًا إلى المنطقة الزمنية التلقائية للنظام على الجهاز. في نظام التشغيل Android 13 والإصدارات الأقدم (المستوى 33 لواجهة برمجة التطبيقات والإصدارات الأقدم)، يمكن الكتابة إلى Health Connect بدون تحديد أي معلومات عن الإزاحة الزمنية، ويجب تجنُّب ذلك قدر الإمكان.
إعدادات الوقت والمنطقة
يؤدي تحديد معلومات إزاحة المنطقة الزمنية أثناء كتابة البيانات إلى توفير معلومات المنطقة الزمنية عند قراءة البيانات في Health Connect. ومع ذلك، قد لا يتمكّن من ذلك في بعض الحالات، مثل عدم توفير إزاحة المنطقة الزمنية. يجب أن يكون تطبيقك جاهزًا للتعامل مع كلا النوعين من البيانات بطريقة مناسبة لظروفك المحدّدة.