يخزّن تطبيق Health Connect بيانات الصحة واللياقة البدنية وينشئها. كما أنها تمثل لكيفية قياس أنواع البيانات المختلفة. تشمل أنواع البيانات هذه معدّل نبضات القلب. القياسات التي يتم اتخاذها على الفور، وعدد الخطوات التي تم اتخاذها بمرور الوقت، وبيانات النوم التي تم اتخاذها في الجلسات.
من المهم أن تفهم أولاً أنواع البيانات والأذونات - الصحة ربط العروض كي تتمكّن من التخطيط لمتطلبات تطبيقك. بذلك، تحتاج إلى مراجعة أنواع بياناتك قبل أن تتمكن من إنهاء المتطلبات.
فئات أنواع البيانات
يوفّر تطبيق Health Connect أنواع البيانات المستخدمة في معظم مجالات الصحة واللياقة البدنية. التطبيقات لتقديم أكبر قدر ممكن من التنوع. يهدف تطبيق Health Connect إلى توفير عرض شامل لبيانات الصحة واللياقة البدنية وتخزينها. تقع أنواع البيانات هذه ضمن الفئات التالية:
- النشاط: يؤدي هذا الخيار إلى تسجيل أي نشاط ينفّذه المستخدم. يمكن أن تشمل أنشطة الصحة واللياقة البدنية مثل الجري والسباحة والنوم.
- قياس النص: يسجِّل هذا الإعداد البيانات الشائعة ذات الصلة بالجسم، مثل وزن المستخدم ومعدل الأيض الأساسي.
- تتبُّع الدورة الشهرية: يتم تسجيل دورات الحيض الشهرية ونقاط البيانات ذات الصلة بها، مثل النتيجة الثنائية لاختبار الإباضة.
- التغذية: لتسجيل أنواع بيانات استهلاك السوائل والتغذية. السابق كمية الماء التي يستهلكها المستخدم في مشروب واحد. الخيار الأخير على حقول اختيارية مثل السعرات الحرارية والسكر والمغنيسيوم.
- النوم: يسجّل هذا الخيار بيانات الفترات الزمنية المتعلقة بطول المستخدم ونوعه. النوم.
- المؤشرات الحيوية: تجمع معلومات أساسية حول المؤشرات العامة للمستخدم صحتك. وهي تشمل بيانات مثل درجة حرارة الجسم ونسبة الغلوكوز في الدم ودم. والضغط عليه وتشبع الأكسجين في الدم.
تنسيق نوع البيانات
يتم تخزين أنواع البيانات في Health Connect في العناصر التي تندرج ضمن فئات فرعية من
Record
لكل نوع بيانات، هناك حقول مرتبطة إما عامة مثل
time وzoneOffset، أو محدّدة مثل title وcount وpercentage.
تستخدم بعض الحقول أنواعًا بسيطة مثل طويلة أو مزدوجة أو سلسلة، بينما يستخدم البعض الآخر
أنواعًا معقدة مثل التعداد والفئات مثل Instant
ZoneOffset قد تكون سمات هذه الحقول مطلوبة أو
اختيارية. بعض السمات للقراءة فقط، ويتم تثبيت بعض السمات
نطاق معين من القيم.
للحصول على القائمة الكاملة لأنواع البيانات المتاحة وحقولها، يُرجى الرجوع إلى الفئات. في Jetpack.
سمات البيانات الإضافية
تتضمّن البيانات في Health Connect API أيضًا سمات البيانات الوصفية. الموضحة في القائمة التالية:
- رقم تعريف 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 معادلة المنطقة بناءً على المنطقة الزمنية التلقائية للنظام للجهاز. في نظام التشغيل Android 13 والإصدارات الأقدم (المستوى 33 من واجهة برمجة التطبيقات والإصدارات الأقدم)، من الممكن الكتابة إلى Health Connect بدون تحديد أي معلومات موازنة في المنطقة، والتي يجب تجنبها كلما أمكن ذلك.
إعداد الوقت والمنطقة
يوفر تحديد معلومات إزاحة المنطقة أثناء كتابة البيانات المنطقة الزمنية المعلومات عند قراءة البيانات في Health Connect. ومع ذلك، قد يفشل في ذلك في حالات معيّنة، مثل عدم توفير قيمة معادلة المنطقة تطبيقك إلى الاستعداد للتعامل مع كلا نوعي البيانات، بطريقة منطقية وفقًا لظروفك الخاصة.
الأذونات
قبل طلب أي أذونات، يجب أن يفصح تطبيقك عنها في ملف البيان. أولاً. راجِع الجداول التالية للاطّلاع على التعيين الكامل لأنواع البيانات الأذونات.
للإصدار 1.0.0-alpha10 والإصدارات الأحدث
| تسجيل نوع الصف | قراءة بيان الأذونات وكتابته |
|---|---|
| ActiveCaloriesBurned |
android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| BasalBodyBody |
android.permission.health.READ_BASAL_BODY_ الضرائب
android.permission.health.WRITE_BASAL_BODY_ الضرائب |
| BasalMetabolicRate |
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 |
| CervicalMucus |
android.permission.health.READ_CERVical_MUCUS
android.permission.health.WRITE_CERVical_MUCUS |
| سلسلة نقاط التواصل في قيادة الدراجات |
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 |
| ممارسة الجلسة |
android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE |
| صعود الطوابق |
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_RESting_HEART_RATE
android.permission.health.WRITE_RESting_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 |
| TotalCaloriesBurned |
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 |
| WheelcarPushes |
android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES |
للإصدار 1.0.0-alpha09 والإصدارات الأقدم
| تسجيل نوع الصف | قراءة بيان الأذونات وكتابته |
|---|---|
| ActiveCaloriesBurned |
androidx.health.permission.ActiveCaloriesBurned.READ
androidx.health.permission.ActiveCaloriesBurned.WRITE |
| BasalBodyBody |
androidx.health.permission.BasalBodyDuration.READ
androidx.health.permission.BasalBodyLength.كتابة |
| BasalMetabolicRate |
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.Body والآراء.READ
androidx.health.permission.درجة حرارة الجسم.كتابة |
| BodyWaterMass |
androidx.health.permission.BodyWaterMass.READ
androidx.health.permission.BodyWaterMass.WRITE |
| BoneMass |
androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.WRITE |
| CervicalMucus |
androidx.health.permission.CervicalMucus.READ
androidx.health.permission.CervicalMucus.WRITE |
| سلسلة نقاط التواصل في قيادة الدراجات |
androidx.health.permission.CyclingPedalingCadence.READ
androidx.health.permission.CyclingPedalingCadence.كتابة |
| المسافة |
androidx.health.permission.Space.READ
سمة androidx.health.permission.مسافة.كتابة |
| الارتفاع المكتسَب |
androidx.health.permission.ElevationGrowed.READ
androidx.health.permission.ElevationGrowed.كتابة |
| ممارسة الجلسة |
androidx.health.permission.ExerciseSession.READ
androidx.health.permission.ExerciseSession.WRITE |
| صعود الطوابق |
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.كتابة |
| 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.كتابة |
| القوة |
androidx.health.permission.Power.READ
androidx.health.permission.Power |
| معدّل التنفس |
androidx.health.permission.RespiratoryRate.READ
androidx.health.permission.RespiratoryRate.WRITE |
| معدّل الراحة |
androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeartRate.WRITE |
| النشاط الجنسي |
androidx.health.permission.BehaviorActivity.READ
اكتب androidx.health.permission.الجنسActivity.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. |
| TotalCaloriesBurned |
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.كتابة |
| WheelcarPushes |
androidx.health.permission.WheelchairPushes.READ
androidx.health.permission.WheelcarPushes.WRITE |
مراجعة أنواع البيانات والأذونات
بعد أن تم تخطيط أنواع البيانات والأذونات، يمكنك تنفيذ خلال مرحلة التطوير.
عند مراجعة تطبيقك قبل تحميله إلى "متجر Play"، تأكَّد من أنّه قائمة أنواع البيانات والأذونات التي يتطلبها تطبيقك. يتيح لك هذا توضيح استخدام تطبيقك للبيانات بدقة
عند الاستعداد لنشر تطبيقك على "متجر Play"، توضيح إمكانية وصول تطبيقك إلى أنواع بيانات Health Connect استخداماتنا. وبخلاف ذلك، قد تظهر رسالة خطأ للمستخدمين حيث يظهر تطبيقك يتعذّر الوصول إلى أنواع بيانات Health Connect لأنها تتطلب أنواعًا خاصة من البيانات والموافقة.