Health Connect هم دادههای سلامتی و تناسب اندام و هم دادههای پرونده پزشکی را ذخیره و ساختاربندی میکند. مهم است که ابتدا بدانید Health Connect چه نوع دادهها و اجازههایی را ارائه میدهد تا بتوانید الزامات برنامهتان را برنامهریزی کنید.
پساز توسعه، وقتی برای انتشار برنامهتان در Google Play آماده میشوید، باید استفاده برنامهتان از دادهها را اعلام کنید و همچنین دسترسی به انواع داده Health Connect را که برنامهتان استفاده میکند اعلام کنید. درغیراینصورت، ممکن است پیام خطایی به کاربران نشان داده شود که میگوید برنامهتان نمیتواند به انواع داده Health Connect دسترسی داشته باشد چون این انواع داده به تأیید ویژه نیاز دارند.
برای اطلاعات بیشتر، تکمیل اظهارنامه برنامههای سلامتی در «کنسول Play» را ببینید.
دستههای نوع داده
Health Connect از انواع دادههایی پشتیبانی میکند که در اکثر برنامههای سلامتی و تناسب اندام استفاده میشوند تا بیشترین تنوع ممکن را ارائه دهد. هدف Health Connect ارائه نمای جامع و ذخیرهسازی دادههای سلامتی و تناسب اندام است. این انواع داده در دستههای زیر قرار میگیرند:
| دسته | شرح | |
|---|---|---|
| directions_run | فعالیت | این گزینه هر فعالیتی را که کاربر انجام میدهد ضبط میکند. این دادهها میتواند شامل فعالیتهای سلامتی و تناسب اندام مثل دویدن و شنا کردن باشد. |
| straighten | سنجههای بدن | این دسته دادههای رایج مربوط به بدن را ضبط میکند، مثل وزن کاربر و سرعت سوختوساز پایه او. |
| fertile | پیگیری قاعدگی | این ویژگی چرخههای قاعدگی و نقاط داده مرتبط را ضبط میکند، مثل نتیجه دودویی آزمایش تخمکگذاری. |
| grocery | تغذیه | این بخش انواع دادههای آبرسانی و تغذیه را ضبط میکند. مورد اول نشاندهنده مقدار آبی است که کاربر در یکبار نوشیدن مصرف میکند. مورد دوم شامل فیلدهای اختیاری مانند کالری، قند، و منیزیم است. |
| sleep_auto | خواب | این دادههای بازهای مربوط به طول و نوع خواب کاربر را ضبط میکند. |
| vital_signs | علائم حیاتی | این بخش اطلاعات ضروری درباره سلامت عمومی کاربر را ضبط میکند. این شامل دادههایی مثل دمای بدن، قند خون، فشار خون، و اشباع اکسیژن خون میشود. |
| mindfulness | تندرستی | این مورد دادههای مربوط به سلامت روان و تندرستی کاربر را ضبط میکند. |
راهنماهای تجربه توسعهدهنده
Health Connect راهنماهای تجربه توسعهدهنده را ارائه میدهد که بر موارد استفاده خاص سلامتی و تناسب اندام تمرکز دارند. این راهنماها به شما نشان میدهند که چگونه از انواع دادههای مرتبط باهم برای ساختن ویژگیهایی برای حوزههای زیر استفاده کنید:
جدول نوع داده زیر همچنین نشان میدهد که کدام راهنماهای تجربه با هر نوع داده مرتبط هستند.
فیلدهای نوع داده
جدول انواع داده Health Connect شامل چندین ستون فیلد است تا به شما کمک کند ساختار و الزامات هر نوع داده را درک کنید. این ستونها بهصورت زیر است:
| فیلد | شرح | |
|---|---|---|
| schedule | نوع گزارش | نشان میدهد که دادهها در یک لحظه از زمان ثبت شدهاند یا درطول یک بازه زمانی. مقادیر ممکن عبارتند از: بازه، لحظهای، سری. |
| straighten | واحد | واحد اندازهگیری برای نوع داده (برای مثال، کالری، متر، تعداد). |
| star | فیلدهای اجباری | اینها فیلدهای ضروریای هستند که هنگام نوشتن دادهها برای این نوع داده باید گنجانده شوند تا به حفظ تمامیت و مفید بودن دادهها کمک کنند. |
انواع دادههای سلامتی و تناسب اندام
برنامهتان باید قبلاز درخواست هرگونه اجازه، آنها را در مانیفست اعلام کند. برای اطلاعات بیشتر، به بخش اعلام اجازهها در راهنمای شروع سریع مراجعه کنید.
برای خواندن دادهها وقتی برنامهتان در پسزمینه است، یا برای خواندن دادههای قدیمی، مجموعه دیگری از اجازههای خواندن باید جدا از اجازههای نوع داده اعلام شود:
| اجازه خواندن اضافی | بیانیه اجازهها |
|---|---|
|
خواندن دادهها در پسزمینه
راهنمای نمونه خواندن در پسزمینه |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
|
خواندن دادههای تاریخی
راهنمای خواندن دادههای قدیمیتر از ۳۰ روز |
android.permission.health.READ_HEALTH_DATA_HISTORY |
جدول زیر حاوی فهرست کامل انواع داده است که هرکدام دارای دسته، پرچمها و راهنماهای ویژگی، و اعلامیههای اجازه است.
این جدول برای Health Connect SDK نسخه 1.0.0-alpha10 و بالاتر است. اگر از نسخه پایینتر کیت توسعه نرمافزار استفاده میکنید، انواع داده Health Connect برای کیت توسعه نرمافزار 1.0.0-alpha09 و پایینتر را ببینید.
| نوع داده راهنماها |
دسته | نوع گزارش بیانیه اجازهها پرچم ویژه |
|---|---|---|
| کالری سوزاندهشده درطول فعالیت راهنمای تمرینات راهنمای ردیابی بومی
|
فعالیت | 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 |