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