يخزّن تطبيق Health Connect بيانات الصحة واللياقة البدنية وبيانات السجلات الطبية وينظّمها. من المهم أولاً فهم أنواع البيانات والأذونات التي يوفّرها تطبيق Health Connect حتى تتمكّن من التخطيط لمتطلبات تطبيقك.
بعد الانتهاء من عملية التطوير، وعند الاستعداد لنشر تطبيقك على Google Play، عليك الإفصاح عن كيفية استخدام تطبيقك للبيانات، بالإضافة إلى الإفصاح عن إمكانية الوصول إلى أنواع البيانات التي يستخدمها تطبيقك في Health Connect. وبخلاف ذلك، قد تظهر للمستخدمين رسالة خطأ تفيد بأنّ تطبيقك لا يمكنه الوصول إلى أنواع بيانات Health Connect لأنّها تتطلّب موافقة خاصة.
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إكمال بيان التطبيقات المختصة بالصحة في Play Console.
فئات أنواع البيانات
يتوافق تطبيق Health Connect مع أنواع البيانات المستخدَمة في معظم تطبيقات الصحة واللياقة البدنية لتوفير أكبر قدر ممكن من التنوع. يهدف تطبيق Health Connect إلى توفير عرض شامل لبيانات الصحة واللياقة البدنية وتخزينها. تندرج أنواع البيانات هذه ضمن الفئات التالية:
| الفئة | الوصف | |
|---|---|---|
| directions_run | Activity | تسجّل هذه السمة أي نشاط يجريه المستخدم. ويمكن أن يشمل أنشطة الصحة واللياقة البدنية، مثل الجري والسباحة. |
| straighten | قياسات الجسم | ويجمع هذا النوع بيانات شائعة تتعلّق بالجسم، مثل وزن المستخدم ومعدّل الأيض الأساسي. |
| fertile | تتبُّع الدورة الشهرية | تسجّل هذه الفئة دورات الحيض ونقاط البيانات ذات الصلة، مثل النتيجة الثنائية لاختبار الإباضة. |
| grocery | التغذية | يشمل ذلك أنواع بيانات الترطيب والتغذية. يمثّل الأول كمية الماء التي يستهلكها المستخدم في شربة واحدة. يتضمّن الأخير حقولاً اختيارية، مثل السعرات الحرارية والسكر والمغنيسيوم. |
| sleep_auto | موسيقى للنوم | تسجّل هذه السمة بيانات الفواصل الزمنية المتعلقة بمدة نوم المستخدم ونوعه. |
| vital_signs | المؤشرات الحيوية | يتم من خلالها تسجيل معلومات أساسية حول الصحة العامة للمستخدم. ويشمل بيانات مثل درجة حرارة الجسم ونسبة الغلوكوز في الدم وضغط الدم وتشبّع الدم بالأكسجين. |
| mindfulness | العافية | ويجمع هذا النوع من البيانات معلومات ذات صلة بالصحة العقلية للمستخدم ورفاهيته. |
أدلة تجربة المطوّرين
يوفّر Health Connect أدلة حول تجربة المطوّرين تركّز على حالات استخدام محدّدة في مجالَي الصحة واللياقة البدنية. توضّح لك هذه الأدلة كيفية استخدام أنواع البيانات ذات الصلة معًا لإنشاء ميزات في المجالات التالية:
يوضّح جدول أنواع البيانات التالي أيضًا أدلة التجربة المرتبطة بكل نوع من أنواع البيانات.
حقول أنواع البيانات
يتضمّن جدول أنواع بيانات Health Connect عدة أعمدة حقول لمساعدتك في فهم بنية ومتطلبات كل نوع من أنواع البيانات. في ما يلي هذه الأعمدة:
| الحقل | الوصف | |
|---|---|---|
| schedule | نوع السجلّ | توضّح ما إذا كانت البيانات مسجّلة في لحظة زمنية معيّنة أو على مدار فترة زمنية. القيم المحتمَلة هي: Interval وInstantaneous وSeries. |
| straighten | الوحدة | وحدة قياس نوع البيانات (مثلاً، السعرات الحرارية أو الأمتار أو العدد) |
| star | الحقول الإلزامية | هذه هي الحقول الأساسية التي يجب تضمينها عند كتابة البيانات لهذا النوع من البيانات للمساعدة في الحفاظ على صحّة البيانات وفائدتها. |
أنواع بيانات الصحة واللياقة البدنية
قبل طلب أي أذونات، يجب أن يوضّح تطبيقك هذه الأذونات في ملف البيان. لمزيد من المعلومات، يُرجى الاطّلاع على قسم الإفصاح عن الأذونات في دليل البدء السريع.
يحتوي الجدول التالي على القائمة الكاملة لأنواع البيانات، ويتضمّن كل نوع منها فئة وعلامات ميزات وأدلة وبيانات أذونات.
هذا الجدول مخصّص للإصدار 1.0.0-alpha09 والإصدارات الأقدم من حزمة تطوير البرامج (SDK) لتطبيق Health Connect. إذا كنت تستخدم إصدارًا أحدث من حزمة تطوير البرامج، يمكنك الاطّلاع على أنواع بيانات Health Connect للإصدار 1.0.0-alpha10 والإصدارات الأحدث.
| نوع البيانات الأدلة |
الفئة | نوع السجل بيانات الأذونات علامة الميزة |
|---|---|---|
| السعرات الحرارية المحروقة نتيجة ممارسة نشاط بدني دليل التمارين
|
النشاط | ActiveCaloriesBurnedRecord
androidx.health.permission.ActiveCaloriesBurned.READ androidx.health.permission.ActiveCaloriesBurned.WRITE أنواع البيانات المجمّعةACTIVE_CALORIES_TOTAL |
| مستوى جهد النشاط دليل التمرينات
|
النشاط | ActivityIntensityRecord
FEATURE_ACTIVITY_INTENSITYأنواع البيانات المجمّعةDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
درجة حرارة الجسم الأساسية
|
تتبُّع الدورة الشهرية | BasalBodyTemperatureRecord
androidx.health.permission.BasalBodyTemperature.READ androidx.health.permission.BasalBodyTemperature.WRITE |
معدّل الأيض الأساسي
|
قياسات الجسم | BasalMetabolicRateRecord
androidx.health.permission.BasalMetabolicRate.READ androidx.health.permission.BasalMetabolicRate.WRITE أنواع البيانات المجمّعةBASAL_CALORIES_TOTAL |
| الغلوكوز في الدم دليل المؤشرات الحيوية
|
المؤشرات الحيوية | BloodGlucoseRecord
androidx.health.permission.BloodGlucose.READ androidx.health.permission.BloodGlucose.WRITE |
| ضغط الدم دليل مؤشرات الصحة
|
المؤشرات الحيوية | BloodPressureRecord
androidx.health.permission.BloodPressure.READ androidx.health.permission.BloodPressure.WRITE أنواع البيانات المجمّعةDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
نسبة الدهون بالجسم
|
قياسات الجسم | BodyFatRecord
androidx.health.permission.BodyFat.READ androidx.health.permission.BodyFat.WRITE |
| درجة حرارة الجسم دليل مؤشرات الصحة
|
المؤشرات الحيوية | BodyTemperatureRecord
androidx.health.permission.BodyTemperature.READ androidx.health.permission.BodyTemperature.WRITE |
مقدار كتلة الماء بالجسم
|
قياسات الجسم | BodyWaterMassRecord
androidx.health.permission.BodyWaterMass.READ androidx.health.permission.BodyWaterMass.WRITE |
كتلة العظام
|
قياسات الجسم | BoneMassRecord
androidx.health.permission.BoneMass.READ androidx.health.permission.BoneMass.WRITE |
مخاط عنق الرحم
|
تتبُّع الدورة الشهرية | CervicalMucusRecord
androidx.health.permission.CervicalMucus.READ androidx.health.permission.CervicalMucus.WRITE |
| إيقاع ركوب الدرّاجة دليل التمرينات
|
النشاط | CyclingPedalingCadenceRecord
androidx.health.permission.Exercise.READ androidx.health.permission.Exercise.WRITE أنواع البيانات المجمّعةRPM_AVGRPM_MAXRPM_MIN |
| المسافة دليل التمرينات
|
النشاط | DistanceRecord
androidx.health.permission.Distance.READ androidx.health.permission.Distance.WRITE أنواع البيانات المجمّعةDISTANCE_TOTAL |
| الارتفاع الذي تم تسلّقه دليل التمارين
|
النشاط | ElevationGainedRecord
androidx.health.permission.ElevationGained.READ androidx.health.permission.ElevationGained.WRITE أنواع البيانات المجمّعةELEVATION_GAINED_TOTAL |
| التمرين دليل التدريبات دليل إضافة مسارات التمارين
|
النشاط | ExerciseSessionRecord
androidx.health.permission.ExerciseSession.READ androidx.health.permission.ExerciseSession.WRITE أنواع التمارينعرض جميع أنواع التمارينEXERCISE_TYPE_UNKNOWNEXERCISE_TYPE_BADMINTONEXERCISE_TYPE_BASEBALLEXERCISE_TYPE_BASKETBALLEXERCISE_TYPE_BIKINGEXERCISE_TYPE_BIKING_STATIONARYEXERCISE_TYPE_BOOT_CAMPEXERCISE_TYPE_BOXINGEXERCISE_TYPE_CALISTHENICSEXERCISE_TYPE_CRICKETEXERCISE_TYPE_DANCINGEXERCISE_TYPE_ELLIPTICALEXERCISE_TYPE_EXERCISE_CLASSEXERCISE_TYPE_FENCINGEXERCISE_TYPE_FOOTBALL_AMERICANEXERCISE_TYPE_FOOTBALL_AUSTRALIANEXERCISE_TYPE_FRISBEE_DISCEXERCISE_TYPE_GOLFEXERCISE_TYPE_GUIDED_BREATHINGEXERCISE_TYPE_GYMNASTICSEXERCISE_TYPE_HANDBALLEXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAININGEXERCISE_TYPE_HIKINGEXERCISE_TYPE_ICE_HOCKEYEXERCISE_TYPE_ICE_SKATINGEXERCISE_TYPE_MARTIAL_ARTSEXERCISE_TYPE_PADDLINGEXERCISE_TYPE_PARAGLIDINGEXERCISE_TYPE_PILATESEXERCISE_TYPE_RACQUETBALLEXERCISE_TYPE_ROCK_CLIMBINGEXERCISE_TYPE_ROLLER_HOCKEYEXERCISE_TYPE_ROWINGEXERCISE_TYPE_ROWING_MACHINEEXERCISE_TYPE_RUGBYEXERCISE_TYPE_RUNNINGEXERCISE_TYPE_RUNNING_TREADMILLEXERCISE_TYPE_SAILINGEXERCISE_TYPE_SCUBA_DIVINGEXERCISE_TYPE_SKATINGEXERCISE_TYPE_SKIINGEXERCISE_TYPE_SNOWBOARDINGEXERCISE_TYPE_SNOWSHOEINGEXERCISE_TYPE_SOCCEREXERCISE_TYPE_SOFTBALLEXERCISE_TYPE_SQUASHEXERCISE_TYPE_STAIR_CLIMBINGEXERCISE_TYPE_STAIR_CLIMBING_MACHINEEXERCISE_TYPE_STRENGTH_TRAININGEXERCISE_TYPE_STRETCHINGEXERCISE_TYPE_SURFINGEXERCISE_TYPE_SWIMMING_OPEN_WATEREXERCISE_TYPE_SWIMMING_POOLEXERCISE_TYPE_TABLE_TENNISEXERCISE_TYPE_TENNISEXERCISE_TYPE_VOLLEYBALLEXERCISE_TYPE_WALKINGEXERCISE_TYPE_WATER_POLOEXERCISE_TYPE_WEIGHTLIFTINGEXERCISE_TYPE_WHEELCHAIREXERCISE_TYPE_OTHER_WORKOUTEXERCISE_TYPE_YOGAأنواع البيانات المجمّعةEXERCISE_DURATION_TOTAL |
| عدد الطوابق التي صعدتها دليل التمرينات
|
النشاط | FloorsClimbedRecord
androidx.health.permission.FloorsClimbed.READ androidx.health.permission.FloorsClimbed.WRITE أنواع البيانات المجمّعةFLOORS_CLIMBED_TOTAL |
| معدّل نبضات القلب دليل المؤشرات الحيوية
|
المؤشرات الحيوية | HeartRateRecord
androidx.health.permission.HeartRate.READ androidx.health.permission.HeartRate.WRITE أنواع البيانات المجمّعةBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| تفاوت معدّل ضربات القلب دليلالمؤشرات الحيوية
|
المؤشرات الحيوية | HeartRateVariabilityRmssdRecord
androidx.health.permission.HeartRateVariability.READ androidx.health.permission.HeartRateVariability.WRITE |
الارتفاع
|
قياسات الجسم | HeightRecord
androidx.health.permission.Height.READ androidx.health.permission.Height.WRITE أنواع البيانات المجمّعةHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
الترطيب
|
تغذية | HydrationRecord
androidx.health.permission.Hydration.READ androidx.health.permission.Hydration.WRITE أنواع البيانات المجمّعةVOLUME_TOTAL |
نزيف القُرء
|
تتبُّع الدورة الشهرية | IntermenstrualBleedingRecord
androidx.health.permission.IntermenstrualBleeding.READ androidx.health.permission.IntermenstrualBleeding.WRITE |
كتلة الجسم بدون الدهون
|
قياسات الجسم | LeanBodyMassRecord
androidx.health.permission.LeanBodyMass.READ androidx.health.permission.LeanBodyMass.WRITE |
| الحيض بالنسبة إلى MenstruationFlowRecord:
بالنسبة إلى MenstruationPeriodRecord:
|
تتبُّع الدورة الشهرية | MenstruationFlowRecord
MenstruationPeriodRecord
androidx.health.permission.Menstruation.READ androidx.health.permission.Menstruation.WRITE |
| الاسترخاء دليل تتبُّع الاسترخاء
|
الصحة والعافية | MindfulnessSessionRecord
FEATURE_MINDFULNESS_SESSIONأنواع جلسات اليقظة والوعي التامعرض جميع أنواع جلسات اليقظة الذهنيةMINDFULNESS_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDEDأنواع البيانات المجمّعةMINDFULNESS_DURATION_TOTAL |
التغذية
|
تغذية | NutritionRecord
androidx.health.permission.Nutrition.READ androidx.health.permission.Nutrition.WRITE أنواع البيانات المجمّعةBIOTIN_TOTALCAFFEINE_TOTALCALCIUM_TOTALCHLORIDE_TOTALCHOLESTEROL_TOTALCHROMIUM_TOTALCOPPER_TOTALDIETARY_FIBER_TOTALENERGY_FROM_FAT_TOTALENERGY_TOTALFOLATE_TOTALFOLIC_ACID_TOTALIODINE_TOTALIRON_TOTALMAGNESIUM_TOTALMANGANESE_TOTALMOLYBDENUM_TOTALMONOUNSATURATED_FAT_TOTALNIACIN_TOTALPANTOTHENIC_ACID_TOTALPHOSPHORUS_TOTALPOLYUNSATURATED_FAT_TOTALPOTASSIUM_TOTALPROTEIN_TOTALRIBOFLAVIN_TOTALSATURATED_FAT_TOTALSELENIUM_TOTALSODIUM_TOTALSUGAR_TOTALTHIAMIN_TOTALTOTAL_CARBOHYDRATE_TOTALTOTAL_FAT_TOTALTRANS_FAT_TOTALUNSATURATED_FAT_TOTALVITAMIN_A_TOTALVITAMIN_B12_TOTALVITAMIN_B6_TOTALVITAMIN_C_TOTALVITAMIN_D_TOTALVITAMIN_E_TOTALVITAMIN_K_TOTALZINC_TOTAL |
اختبار الإباضة
|
تتبُّع الدورة الشهرية | OvulationTestRecord
androidx.health.permission.OvulationTest.READ androidx.health.permission.OvulationTest.WRITE |
| نسبة الأكسجين في الدم دليل المؤشرات الحيوية
|
المؤشرات الحيوية | OxygenSaturationRecord
androidx.health.permission.OxygenSaturation.READ androidx.health.permission.OxygenSaturation.WRITE |
| التمارين المخطَّط لها دليل التمرينات دليل خطط التدريب
|
النشاط | PlannedExerciseSessionRecord
androidx.health.permission.PlannedExerciseSession.READ androidx.health.permission.PlannedExerciseSession.WRITE FEATURE_PLANNED_EXERCISE |
| الطاقة دليل التمرينات
|
النشاط | PowerRecord
androidx.health.permission.Power.READ androidx.health.permission.Power.WRITE أنواع البيانات المجمّعةPOWER_AVGPOWER_MAXPOWER_MIN |
| معدّل التنفس دليل "المؤشرات الحيوية"
|
المؤشرات الحيوية | RespiratoryRateRecord
androidx.health.permission.RespiratoryRate.READ androidx.health.permission.RespiratoryRate.WRITE |
| معدّل النبض أثناء الراحة دليل المؤشرات الحيوية
|
المؤشرات الحيوية | RestingHeartRateRecord
androidx.health.permission.RestingHeartRate.READ androidx.health.permission.RestingHeartRate.WRITE أنواع البيانات المجمّعةBPM_AVGBPM_MAXBPM_MIN |
النشاط الجنسي
|
تتبُّع الدورة الشهرية | SexualActivityRecord
androidx.health.permission.SexualActivity.READ androidx.health.permission.SexualActivity.WRITE |
| درجة حرارة الجلد دليل المؤشرات الحيوية دليل قياس درجة حرارة الجلد
|
المؤشرات الحيوية | SkinTemperatureRecord
FEATURE_SKIN_TEMPERATUREأنواع البيانات المجمّعةTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| جلسة النوم دليل النوم دليل تتبُّع جلسات النوم
|
النوم | SleepSessionRecord
androidx.health.permission.SleepSession.READ androidx.health.permission.SleepSession.WRITE أنواع البيانات المجمّعةSLEEP_DURATION_TOTAL |
| السرعة دليل التمارين
|
النشاط | SpeedRecord
androidx.health.permission.Speed.READ androidx.health.permission.Speed.WRITE أنواع البيانات المجمّعةSPEED_AVGSPEED_MAXSPEED_MIN |
| الخطوات دليل التمرينات بالنسبة إلى StepsRecord:
بالنسبة إلى StepsCadenceRecord:
|
النشاط | StepsRecord
StepsCadenceRecord
androidx.health.permission.Steps.READ androidx.health.permission.Steps.WRITE أنواع البيانات المجمّعة لـ StepsRecordCOUNT_TOTALأنواع البيانات المجمّعة لـ StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| إجمالي السعرات الحرارية المحروقة دليل التمارين
|
النشاط | TotalCaloriesBurnedRecord
androidx.health.permission.TotalCaloriesBurned.READ androidx.health.permission.TotalCaloriesBurned.WRITE أنواع البيانات المجمّعةENERGY_TOTAL |
| الحد الأقصى لاستهلاك الأكسجين دليل التمرينات
|
النشاط | Vo2MaxRecord
androidx.health.permission.VO2Max.READ androidx.health.permission.VO2Max.WRITE |
الوزن
|
قياسات الجسم | WeightRecord
androidx.health.permission.Weight.READ androidx.health.permission.Weight.WRITE أنواع البيانات المجمّعةWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| عدد دفعات الكرسي المتحرك دليل التمرينات
|
النشاط | WheelchairPushesRecord
androidx.health.permission.WheelchairPushes.READ androidx.health.permission.WheelchairPushes.WRITE أنواع البيانات المجمّعةCOUNT_TOTAL |