يخزّن تطبيق Health Connect بيانات الصحة واللياقة البدنية وبيانات السجلات الطبية وينظّمها. من المهم أولاً فهم أنواع البيانات والأذونات التي يوفّرها تطبيق Health Connect حتى تتمكّن من التخطيط لمتطلبات تطبيقك.
بعد الانتهاء من عملية التطوير، وعند الاستعداد لنشر تطبيقك على "متجر Play"، عليك الإفصاح عن كيفية استخدام تطبيقك للبيانات، بالإضافة إلى الإفصاح عن إمكانية الوصول إلى أنواع البيانات التي يستخدمها تطبيقك في Health Connect. وبخلاف ذلك، قد تظهر للمستخدمين رسالة خطأ تفيد بأنّ تطبيقك لا يمكنه الوصول إلى أنواع بيانات Health Connect لأنّها تتطلّب موافقة خاصة.
لمزيد من المعلومات، يُرجى الاطّلاع على إكمال بيان التطبيقات المختصة بالصحة في Play Console.
فئات أنواع البيانات
يتيح تطبيق Health Connect أنواع البيانات المستخدَمة في معظم تطبيقات الصحة واللياقة البدنية لتوفير أكبر قدر ممكن من التنوع. يهدف تطبيق Health Connect إلى توفير عرض شامل وتخزين لبيانات الصحة واللياقة البدنية. وتنقسم أنواع البيانات هذه إلى الفئات التالية:
| الفئة | الوصف | |
|---|---|---|
| directions_run | النشاط | تسجّل هذه السمة أي نشاط يجريه المستخدم. ويمكن أن يشمل أنشطة الصحة واللياقة البدنية، مثل الجري والسباحة. |
| تقويم | قياسات الجسم | ويشمل هذا النوع البيانات الشائعة المتعلّقة بالجسم، مثل وزن المستخدم ومعدّل الأيض الأساسي. |
| خصب | تتبُّع الدورة الشهرية | تسجّل هذه الفئة دورات الحيض ونقاط البيانات ذات الصلة، مثل النتيجة الثنائية لاختبار الإباضة. |
| بقالة | التغذية | تتضمّن هذه الفئة أنواع بيانات الترطيب والتغذية. يمثّل الأول كمية الماء التي يستهلكها المستخدم في شربة واحدة. وتشمل الأخيرة حقولاً اختيارية، مثل السعرات الحرارية والسكر والمغنيسيوم. |
| sleep_auto | موسيقى للنوم | تسجّل هذه السمة بيانات الفواصل الزمنية المتعلقة بمدة نوم المستخدم ونوعه. |
| المؤشرات_الحيوية | المؤشرات الحيوية | يتم من خلالها تسجيل معلومات أساسية حول الصحة العامة للمستخدم. وتشمل بيانات مثل درجة حرارة الجسم ونسبة الغلوكوز في الدم وضغط الدم ونسبة الأكسجين في الدم. |
| الوعي التام | الصحة والعافية | ويجمع هذا النوع من البيانات معلومات ذات صلة بالصحة العقلية للمستخدم وعافيته. |
أدلة تجربة المطوّرين
يوفّر Health Connect أدلة حول تجربة المطوّرين تركّز على حالات استخدام محدّدة للصحة واللياقة البدنية. توضّح لك هذه الأدلة كيفية استخدام أنواع البيانات ذات الصلة معًا لإنشاء ميزات من أجل:
يوضّح جدول أنواع البيانات التالي أيضًا أدلة التجربة المرتبطة بكل نوع من أنواع البيانات.
حقول أنواع البيانات
يتضمّن جدول أنواع بيانات Health Connect عدة أعمدة حقول لمساعدتك في فهم بنية ومتطلبات كل نوع من أنواع البيانات. في ما يلي هذه الأعمدة:
| الحقل | الوصف | |
|---|---|---|
| جدول | نوع السجلّ | توضّح ما إذا كانت البيانات مسجّلة في لحظة زمنية أو على مدار فترة زمنية. القيم المحتمَلة هي: Interval وInstantaneous وSeries. |
| تقويم | الوحدة | وحدة قياس نوع البيانات (مثل السعرات الحرارية أو الأمتار أو العدد) |
| نجمة | الحقول الإلزامية | هذه هي الحقول الأساسية التي يجب تضمينها عند كتابة البيانات لهذا النوع من البيانات للمساعدة في الحفاظ على صحّة البيانات وفائدتها. |
أنواع بيانات الصحة واللياقة البدنية
قبل طلب أي أذونات، يجب أن يوضّح تطبيقك هذه الأذونات في ملف البيان. يمكنك الاطّلاع على قسم الإفصاح عن الأذونات في دليل البدء السريع للحصول على مزيد من المعلومات.
لقراءة البيانات أثناء تشغيل تطبيقك في الخلفية أو لقراءة البيانات السابقة، يجب الإفصاح عن مجموعة إضافية من أذونات القراءة بشكل منفصل عن أذونات أنواع البيانات:
| إذن قراءة إضافي | بيان الأذونات |
|---|---|
|
قراءة البيانات في الخلفية
دليل مثال على القراءة في الخلفية |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
|
قراءة البيانات القديمة
دليل قراءة البيانات الأقدم من 30 يومًا |
android.permission.health.READ_HEALTH_DATA_HISTORY |
1. اختيار إصدار Jetpack
تختلف بيانات أذونات الوصول بين إصدارات Jetpack، لذا احرص على اختيار نطاق إصدار Jetpack الذي يستخدمه تطبيقك.
2- فلترة جدول أنواع البيانات
يحتوي الجدول التالي على القائمة الكاملة لأنواع البيانات، ويتضمّن كل نوع منها فئة وعلامات ميزات وأدلة وبيانات أذونات.
| نوع البيانات الأدلة |
الفئة | نوع السجل بيانات الأذونات علامة الميزة |
|---|---|---|
| السعرات الحرارية المحروقة نتيجة ممارسة نشاط بدني دليل التمارين
|
النشاط | ActiveCaloriesBurnedRecord
android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED أنواع البيانات المجمّعةACTIVE_CALORIES_TOTAL |
| مستوى جهد النشاط دليلالتمارين
|
النشاط | ActivityIntensityRecord
android.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITYأنواع البيانات المجمّعةDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
درجة حرارة الجسم الأساسية
|
تتبُّع الدورة الشهرية | BasalBodyTemperatureRecord
android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
معدّل الأيض الأساسي
|
قياسات الجسم | BasalMetabolicRateRecord
android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE أنواع البيانات المجمّعةBASAL_CALORIES_TOTAL |
| الغلوكوز في الدم دليل المؤشرات الحيوية
|
المؤشرات الحيوية | BloodGlucoseRecord
android.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| ضغط الدم دليل مؤشرات الصحة
|
المؤشرات الحيوية | BloodPressureRecord
android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE أنواع البيانات المجمّعةDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
نسبة الدهون بالجسم
|
قياسات الجسم | BodyFatRecord
android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| درجة حرارة الجسم دليل المؤشرات الحيوية
|
المؤشرات الحيوية | BodyTemperatureRecord
android.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
مقدار كتلة الماء بالجسم
|
قياسات الجسم | BodyWaterMassRecord
android.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
كتلة العظام
|
قياسات الجسم | BoneMassRecord
android.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
مخاط عنق الرحم
|
تتبُّع الدورة الشهرية | CervicalMucusRecord
android.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
| إيقاع الدواسة في ركوب الدرّاجة دليل التمارين
|
النشاط | CyclingPedalingCadenceRecord
android.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE أنواع البيانات المجمّعةRPM_AVGRPM_MAXRPM_MIN |
| المسافة دليل التمرينات
|
النشاط | DistanceRecord
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE أنواع البيانات المجمّعةDISTANCE_TOTAL |
| الارتفاع الذي تم تسلّقه دليل التمارين
|
النشاط | ElevationGainedRecord
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED أنواع البيانات المجمّعةELEVATION_GAINED_TOTAL |
| التمرين دليل التمرينات دليل إضافة مسارات التمارين
|
النشاط | ExerciseSessionRecord
android.permission.health.READ_EXERCISE android.permission.health.READ_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE android.permission.health.WRITE_EXERCISE_ROUTE أنواع التمارينعرض جميع أنواع التمارين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
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED أنواع البيانات المجمّعةFLOORS_CLIMBED_TOTAL |
| معدّل نبضات القلب دليل المقاييس الحيوية
|
المؤشرات الحيوية | HeartRateRecord
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE أنواع البيانات المجمّعةBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| تغيُّر معدّل نبضات القلب دليل المؤشرات الحيوية
|
المؤشرات الحيوية | HeartRateVariabilityRmssdRecord
android.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
الارتفاع
|
قياسات الجسم | HeightRecord
android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT أنواع البيانات المجمّعةHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
الترطيب
|
المعلومات الغذائية | HydrationRecord
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION أنواع البيانات المجمّعةVOLUME_TOTAL |
نزيف القُرء
|
تتبُّع الدورة الشهرية | IntermenstrualBleedingRecord
android.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
كتلة الجسم بدون الدهون
|
قياسات الجسم | LeanBodyMassRecord
android.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| الحيض بالنسبة إلى MenstruationFlowRecord:
بالنسبة إلى MenstruationPeriodRecord:
|
تتبُّع الدورة الشهرية | MenstruationFlowRecord
MenstruationPeriodRecord
android.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| اليقظة دليل تتبُّع اليقظة
|
الصحة والعافية | MindfulnessSessionRecord
android.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS 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
android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION أنواع البيانات المجمّعة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
android.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
| نسبة الأكسجين في الدم دليل المؤشرات الحيوية
|
المؤشرات الحيوية | OxygenSaturationRecord
android.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| التمارين المخطَّط لها دليل التمرينات دليل خطط التدريب
|
النشاط | PlannedExerciseSessionRecord
android.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
| الطاقة دليل التمرينات
|
النشاط | PowerRecord
android.permission.health.READ_POWER android.permission.health.WRITE_POWER أنواع البيانات المجمّعةPOWER_AVGPOWER_MAXPOWER_MIN |
| معدّل التنفس دليل "المؤشرات الحيوية"
|
المؤشرات الحيوية | RespiratoryRateRecord
android.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
| معدّل النبض أثناء الراحة دليل المؤشرات الحيوية
|
المؤشرات الحيوية | RestingHeartRateRecord
android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE أنواع البيانات المجمّعةBPM_AVGBPM_MAXBPM_MIN |
النشاط الجنسي
|
تتبُّع الدورة الشهرية | SexualActivityRecord
android.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| درجة حرارة الجلد دليل المؤشرات الحيوية دليل قياس درجة حرارة الجلد
|
المؤشرات الحيوية | SkinTemperatureRecord
android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATUREأنواع البيانات المجمّعةTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| جلسة النوم دليل النوم دليل تتبُّع جلسات النوم
|
النوم | SleepSessionRecord
android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP أنواع البيانات المجمّعةSLEEP_DURATION_TOTAL |
| السرعة دليل التمارين
|
النشاط | SpeedRecord
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED أنواع البيانات المجمّعةSPEED_AVGSPEED_MAXSPEED_MIN |
| الخطوات دليل التمرينات بالنسبة إلى StepsRecord:
بالنسبة إلى StepsCadenceRecord:
|
النشاط | StepsRecord
StepsCadenceRecord
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS أنواع البيانات المجمّعة لـ StepsRecordCOUNT_TOTALأنواع البيانات المجمّعة لـ StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| إجمالي السعرات الحرارية المحروقة دليل التمرينات
|
النشاط | TotalCaloriesBurnedRecord
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED أنواع البيانات المجمّعةENERGY_TOTAL |
| السعة القصوى للأكسجين دليل التمارين
|
النشاط | Vo2MaxRecord
android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
الوزن
|
قياسات الجسم | WeightRecord
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT أنواع البيانات المجمّعةWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| عدد دفعات الكرسي المتحرك دليل التمرينات
|
النشاط | WheelchairPushesRecord
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES أنواع البيانات المجمّعةCOUNT_TOTAL |