يخزِّن تطبيق Health Connect بيانات الصحة واللياقة البدنية وينظّمها. كما يأخذ في الحسبان كيفية قياس أنواع البيانات المختلفة. تتضمن أنواع البيانات هذه قياسات معدل ضربات القلب التي يتم اتخاذها على الفور وعدد الخطوات التي يتم اتخاذها بمرور الوقت وبيانات النوم التي تم اتخاذها في الجلسات.
من المهم التعرّف أولاً على أنواع البيانات والأذونات التي يوفّرها تطبيق Health Connect لتتمكّن من التخطيط لمتطلبات التطبيق. بذلك، تحتاج إلى مراجعة أنواع البيانات الخاصة بك قبل أن تتمكن من إنهاء متطلباتك.
فئات نوع البيانات
يتوافق Health Connect مع أنواع البيانات المستخدَمة في معظم تطبيقات الصحة واللياقة البدنية لتقديم أكبر قدر ممكن من التنوع. يهدف Health Connect إلى توفير عرض شامل لبيانات الصحة واللياقة البدنية وتخزينها. وتنقسم أنواع البيانات هذه إلى الفئات التالية:
- النشاط: يؤدي ذلك إلى تسجيل أي نشاط ينفّذه المستخدم. يمكن أن تشمل أنشطة الصحة واللياقة البدنية مثل الجري والسباحة والنوم.
- قياسات الجسم: تساعد هذه الميزة في تسجيل البيانات الشائعة المتعلقة بالجسم، مثل وزن المستخدم ومعدّل الأيض الأساسي لديه.
- تتبُّع الدورة الشهرية: يتم استخدام هذه الميزة لتسجيل الدورة الشهرية ونقاط البيانات ذات الصلة بها، مثل النتيجة الثنائية لاختبار الإباضة.
- التغذية: لتسجيل أنواع بيانات الترطيب والتغذية. يمثل الأول مقدار المياه التي يستهلكها المستخدم في مشروب واحد. يتضمن الأخير حقولاً اختيارية مثل السعرات الحرارية والسكر والمغنيسيوم.
- النوم: يسجّل هذا الإجراء بيانات الفاصل الزمني المتعلقة بطول المستخدم ونوع نومه.
- المؤشرات الحيوية: تجمع معلومات أساسية حول الصحة العامة للمستخدم. وهي تشمل بيانات مثل درجة حرارة الجسم ونسبة الغلوكوز في الدم وضغط الدم وتشبّع الأكسجين في الدم.
تنسيق نوع البيانات
يتم تخزين أنواع البيانات في Health Connect في كائنات ضمن فئات فرعية من Record.
بالنسبة إلى كل نوع بيانات، تتوفّر حقول مرتبطة تكون عامة مثل
time وzoneOffset أو خاصة مثل title وcount وpercentage.
تستخدم بعض الحقول أنواعًا بسيطة، مثل طويلة أو مزدوجة أو سلسلة، بينما يستخدم البعض الآخر أنواعًا معقدة مثل التعداد والفئات، مثل Instant وZoneOffset. قد تكون سمات هذه الحقول مطلوبة
أو اختيارية. تتوفّر بعض السمات للقراءة فقط، وبعضها مرتبط بنطاق معيّن من القيم.
للحصول على القائمة الكاملة لأنواع البيانات المتاحة وحقولها، يُرجى الرجوع إلى الفئات في Jetpack.
سمات البيانات الإضافية
تتضمّن البيانات في Health Connect API أيضًا سمات البيانات الوصفية الموضّحة في القائمة التالية:
- معرّف Health Connect: يتم تخصيص معرّف فريد (UID) لكل نقطة بيانات عند إنشائها. وهذا مفيد لعمليات القراءة والكتابة القياسية. يُرجى الاطّلاع على رقم تعريف Health Connect للحصول على مزيد من التفاصيل.
- وقت آخر تعديل: يشير ذلك إلى الطابع الزمني لآخر مرة تم فيها تعديل البيانات في السجلّ. يتم إنشاؤها تلقائيًا عند أول إنشاء للسجل أو عند كل تحديث.
- مصدر البيانات: يخزِّن Health Connect معلومات حول التطبيق الذي مصدر البيانات. يحتوي على اسم الحزمة لهذا المصدر، والذي تتم إضافته تلقائيًا عند الإنشاء.
- الجهاز: يخزِّن تطبيق Health Connect معلومات حول الجهاز الذي تم الحصول على البيانات منه. وهي تحتوي على الشركة المصنعة لذلك الجهاز وطرازه، واللذين توفران القيمة يدويًا.
- معرّف العميل: يوفّر تطبيق Health Connect معرّفات العملاء لكي تتمكّن تطبيقات العميل من الرجوع إلى البيانات باستخدام معرّفاتها، ما يساعد في حل التعارضات ويسهّل عملية المزامنة. يتم توفير هذا للسجلّ يدويًا.
- إصدار سجلّ العميل: إلى جانب معرِّف العميل، يوفّر Health Connect إصدارات للمساعدة في تتبُّع التغييرات أثناء مزامنة البيانات. يتم توفير ذلك للسجل يدويًا.
- طريقة التسجيل: يتيح لك تطبيق Health Connect فهم كيفية تسجيل البيانات. تتضمن هذه الطرق التطبيقات التي تسجِّل البيانات بشكل سلبي (تلقائيًا)، والمستخدمين الذين يسجِّلون البيانات بنشاط أو يدويًا.
رقم تعريف Health Connect
يعيّن تطبيق Health Connect معرّفات فريدة (معرّفات UID) لعناصر البيانات التي تم إدراجها حديثًا، والتي تحدد عناصر البيانات وتميّزها عن غيرها. تعد معرّفات Health Connect مفيدة في طلبات القراءة أو الكتابة. لا تتطابق معرّفات Health Connect مع معرّفات العملاء. يعيّن تطبيق العملاء معرّفات Client ID، في حين يعيّن 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. ومع ذلك، فقد تفشل في القيام بذلك في مواقف معينة، مثل عندما لا يتم توفير معادلة المنطقة. يحتاج تطبيقك إلى أن يكون مستعدًا للتعامل مع كلا النوعين من البيانات، بطريقة منطقية لظروفك المحددة.
الأذونات
قبل طلب أي أذونات، يجب أن يفصح التطبيق عنها في ملف البيان أولاً. راجِع الجداول التالية للاطّلاع على التعيين الكامل لأنواع البيانات وأذوناتها.
للإصدارات 1.0.0-alpha10 والإصدارات الأحدث
| تسجيل نوع الصف | بيان إذن القراءة والكتابة |
|---|---|
| حرق سعرات حرارية |
android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| درجة حرارة الجسم الأساسية |
android.permission.health.READ_BASAL_BODY_موجة
android.permission.health.WRITE_BASAL_BODY_ درجات الحرارة |
| معدّل التمثيل الغذائي الأساسي |
android.permission.health.READ_BASAL_metaBOLIC_RATE
android.permission.health.WRITE_BASAL_metaBOLIC_RATE |
| غلوكوز في الدم |
android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE |
| ضغط الدم |
android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE |
| BodyFat |
android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT |
| درجة حرارة الجسم |
android.permission.health.READ_BODY_تمت
android.permission.health.WRITE_BODY_ درجات الحرارة |
| BodyWaterMass |
android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS |
| BoneMass |
android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS |
| مخاط عنق الرحم |
android.permission.health.READ_CERVical_MUCUS
android.permission.health.WRITE_CERVical_MUCUS |
| CyclingPedalingCadence |
android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE |
| المسافة |
android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE |
| الارتفاع الذي تم تحقيقه |
android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED |
| ExerciseSession |
android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE |
| FloorsClimbed |
android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED |
| معدّل نبضات القلب |
android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE |
| HeartRateVariabilityRmssd |
android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY |
| الارتفاع |
android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT |
| الترطيب |
android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION |
| نزيف القُرء |
android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
| LeanBodyMass |
android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS |
| MenstruationFlow |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
| فترة الحيض |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
| التغذية |
android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION |
| اختبار الإباضة |
android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST |
| تشبّع الأكسجين في الدم |
android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION |
| القوة |
android.permission.health.READ_POWER
android.permission.health.WRITE_POWER |
| معدّل التنفس |
android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE |
| معدّل النبض أثناء الراحة |
android.permission.health.READ_RES وتشمل_HEART_RATE
android.permission.health.WRITE_RESه_HEART_RATE |
| النشاط الجنسي |
android.permission.health.READ_SEXUAL_activity
android.permission.health.WRITE_SEXUAL_ACTIVITY |
| SleepSession |
android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP |
| السرعة |
android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED |
| سلسلة نقاط التواصل |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
| الخطوات |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
| إجمالي السعرات الحرارية المحروقة |
android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
| Vo2Max |
android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX |
| الوزن |
android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT |
| عجلات الكرسي المتحرك |
android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES |
للإصدار 1.0.0-alpha09 والإصدارات الأقدم
| تسجيل نوع الصف | بيان إذن القراءة والكتابة |
|---|---|
| حرق سعرات حرارية |
androidx.health.permission.ActiveCaloriesBurned.READ
androidx.health.permission.ActiveCaloriesBurned.WRITE |
| درجة حرارة الجسم الأساسية |
androidx.health.permission.BasalBodyWeight.READ
androidx.health.permission.BasalBodyBody.WRITE |
| معدّل التمثيل الغذائي الأساسي |
androidx.health.permission.BasalMetabolicRate.READ
androidx.health.permission.BasalMetabolicRate.WRITE |
| غلوكوز في الدم |
androidx.health.permission.BloodGlucose.READ
androidx.health.permission.BloodGlucose.WRITE |
| ضغط الدم |
androidx.health.permission.BloodPressure.READ
androidx.health.permission.BloodPressure.WRITE |
| BodyFat |
androidx.health.permission.BodyFat.READ
androidx.health.permission.BodyFat.WRITE |
| درجة حرارة الجسم |
androidx.health.permission.BodyBody.READ
androidx.health.permission.Body ستحتاج إلى WRITE" |
| BodyWaterMass |
androidx.health.permission.BodyWaterMass.READ
androidx.health.permission.BodyWaterMass.WRITE |
| BoneMass |
androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.WRITE |
| مخاط عنق الرحم |
androidx.health.permission.CervicalMuhouse.READ
androidx.health.permission.CervicalMuكوس.WRITE |
| CyclingPedalingCadence |
androidx.health.permission.CyclingPedalingCadence.READ
androidx.health.permission.CyclingPedalingCadence.WRITE |
| المسافة |
androidx.health.permission.DISTANCE.READ
androidx.health.permission.DISTANCE.WRITE |
| الارتفاع الذي تم تحقيقه |
androidx.health.permission.ElevationGained.READ
androidx.health.permission.ElevationGained.WRITE |
| ExerciseSession |
androidx.health.permission.ExerciseSession.READ
androidx.health.permission.ExerciseSession.WRITE |
| FloorsClimbed |
androidx.health.permission.FloorsClimbed.READ
androidx.health.permission.FloorsClimbed.WRITE |
| معدّل نبضات القلب |
androidx.health.permission.HeartRate.READ
androidx.health.permission.HeartRate.WRITE |
| HeartRateVariabilityRmssd |
androidx.health.permission.HeartRateVariabilityRmssd.READ
androidx.health.permission.HeartRateVariabilityRmssd.WRITE |
| الارتفاع |
androidx.health.permission.Height.READ
androidx.health.permission.Height.WRITE |
| الترطيب |
androidx.health.permission.Hydration.READ
androidx.health.permission.Hydration.WRITE |
| نزيف القُرء |
androidx.health.permission.IntermenstrualBleeding.READ
androidx.health.permission.IntermenstrualBleeding.WRITE |
| LeanBodyMass |
androidx.health.permission.LeanBodyMass.READ
androidx.health.permission.LeanBodyMass.WRITE |
| MenstruationFlow |
androidx.health.permission.MenstruationFlow.READ
androidx.health.permission.MenstruationFlow.WRITE |
| التغذية |
androidx.health.permission.Nutrition.READ
androidx.health.permission.Nutrition.WRITE |
| اختبار الإباضة |
androidx.health.permission.OvulationTest.READ
androidx.health.permission.OvulationTest.WRITE |
| تشبّع الأكسجين في الدم |
androidx.health.permission.OxygenSaturation.READ
androidx.health.permission.OxygenSaturation.WRITE |
| القوة |
androidx.health.permission.Power.READ
androidx.health.permission.Power.WRITE |
| معدّل التنفس |
androidx.health.permission.RespiratoryRate.READ
androidx.health.permission.RespiratoryRate.WRITE |
| معدّل النبض أثناء الراحة |
androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeartRate.WRITE |
| النشاط الجنسي |
androidx.health.permission.relatedActivity.READ
androidx.health.permission.GenderActivity.WRITE |
| SleepSession |
androidx.health.permission.SleepSession.READ
androidx.health.permission.SleepSession.WRITE |
| السرعة |
androidx.health.permission.Speed.READ
androidx.health.permission.Speed.WRITE |
| سلسلة نقاط التواصل |
androidx.health.permission.StepsCadence.READ
androidx.health.permission.StepsCadence.WRITE |
| الخطوات |
androidx.health.permission.Steps.READ
androidx.health.permission.Steps.WRITE |
| إجمالي السعرات الحرارية المحروقة |
androidx.health.permission.TotalCaloriesBurned.READ
androidx.health.permission.TotalCaloriesBurned.WRITE |
| Vo2Max |
androidx.health.permission.Vo2Max.READ
androidx.health.permission.Vo2Max.WRITE |
| الوزن |
androidx.health.permission.Weight.READ
androidx.health.permission.Weight.WRITE |
| عجلات الكرسي المتحرك |
androidx.health.permission.WheelكرسيPushes.READ
androidx.health.permission.WheelchairPushes.WRITE |
مراجعة أنواع البيانات والأذونات
الآن بعد أن تم تخطيط أنواع البيانات والأذونات، يمكنك تنفيذها أثناء التطوير.
عند مراجعة تطبيقك قبل تحميله إلى "متجر Play"، يجب التحقّق جيدًا من قائمة أنواع البيانات والأذونات التي يتطلبها تطبيقك. يتيح لك ذلك الإفصاح بدقة عن استخدام تطبيقك للبيانات.
بعد نشر تطبيقك في "متجر Play"، قد تظهر لك رسالة خطأ تفيد بأنّه لا يمكن لتطبيقك الوصول إلى أنواع بيانات Health Connect لأنّها تتطلّب موافقة خاصة. في هذه الحالة، تحتاج إلى طلب الوصول إلى نوع البيانات من خلال نموذج بيان المطوّرين. لمزيد من المعلومات حول هذه العملية، راجِع طلب الوصول إلى أنواع بيانات Health Connect.