Health Connect داده های سلامت و تناسب اندام را ذخیره و ساختار می دهد. همچنین نحوه اندازه گیری انواع داده های مختلف را در نظر می گیرد. این نوع داده‌ها شامل اندازه‌گیری‌های ضربان قلب است که بلافاصله انجام می‌شود، تعداد قدم‌ها در طول زمان و داده‌های خواب گرفته‌شده در جلسات.
مهم است که ابتدا بدانید Health Connect چه نوع داده‌ها و مجوزهایی را ارائه می‌دهد تا بتوانید نیازهای برنامه خود را برنامه‌ریزی کنید. با این کار، قبل از اینکه بتوانید نیازهای خود را نهایی کنید، باید انواع داده های خود را بررسی کنید.
دسته بندی نوع داده
Health Connect از انواع داده‌هایی پشتیبانی می‌کند که در اکثر برنامه‌های سلامت و تناسب اندام استفاده می‌شوند تا تنوع هرچه بیشتر را ارائه دهند. هدف Health Connect ارائه یک نمای جامع و ذخیره سازی داده های سلامت و تناسب اندام است. این نوع داده ها در دسته های زیر قرار می گیرند:
- Activity: هر فعالیتی که کاربر انجام می دهد را ثبت می کند. این می تواند شامل فعالیت های سلامتی و تناسب اندام مانند دویدن، شنا و خواب باشد.
- اندازه‌گیری بدن: این داده‌های رایج مربوط به بدن، مانند وزن کاربر و میزان متابولیسم پایه آنها را جمع‌آوری می‌کند.
- ردیابی چرخه: این چرخه های قاعدگی و نقاط داده مرتبط، مانند نتیجه دودویی آزمایش تخمک گذاری را ثبت می کند.
- تغذیه: این نوع داده های هیدراتاسیون و تغذیه را ثبت می کند. اولی نشان دهنده مقدار آب مصرفی یک مصرف کننده در یک نوشیدنی است. مورد دوم شامل زمینه های اختیاری مانند کالری، قند و منیزیم است.
- Sleep: این داده‌های بازه‌ای مربوط به طول و نوع خواب کاربر را ضبط می‌کند.
- Vitals: این اطلاعات ضروری در مورد سلامت عمومی کاربر را دریافت می کند. این شامل داده هایی مانند دمای بدن، گلوکز خون، فشار خون و اشباع اکسیژن خون است.
فرمت نوع داده
انواع داده ها در Health Connect در اشیایی که زیر کلاس های Record هستند ذخیره می شوند.
برای هر نوع داده، فیلدهای مرتبطی وجود دارد که یا عمومی هستند مانند time و zoneOffset ، یا خاص مانند title ، count و percentage . برخی از فیلدها از انواع ساده استفاده می کنند - مانند طولانی، دوتایی یا رشته ای - در حالی که برخی دیگر از انواع پیچیده مانند enumerations و کلاس هایی مانند Instant و ZoneOffset استفاده می کنند. ویژگی های این فیلدها می تواند الزامی یا اختیاری باشد. برخی از ویژگی ها فقط خواندنی هستند و برخی از ویژگی ها به محدوده خاصی از مقادیر متصل می شوند.
برای لیست کامل انواع داده های موجود و فیلدهای آنها، به کلاس های Jetpack مراجعه کنید.
ویژگی های داده های اضافی
داده‌های موجود در Health Connect API همچنین شامل ویژگی‌های فراداده است که در لیست زیر توضیح داده شده است:
- شناسه اتصال سلامت: به هر نقطه از داده ها یک شناسه منحصر به فرد (UID) پس از ایجاد اختصاص داده می شود. این برای عملیات خواندن و نوشتن استاندارد مفید است. برای جزئیات بیشتر به Health Connect ID مراجعه کنید.
- آخرین زمان اصلاح شده: این نشان‌دهنده مُهر زمانی آخرین نمونه‌ای است که یک رکورد به‌روزرسانی می‌کند. این به طور خودکار در اولین ایجاد رکورد یا در هر به روز رسانی ایجاد می شود.
- مبدا داده ها: Health Connect اطلاعات مربوط به برنامه ای را که داده ها از آنجا آمده اند ذخیره می کند. این شامل نام بسته آن مبدا است که به طور خودکار پس از ایجاد اضافه می شود.
- دستگاه: Health Connect اطلاعات مربوط به دستگاهی را که داده ها از آنجا آمده اند ذخیره می کند. این شامل سازنده و مدل آن دستگاه است که شما به صورت دستی مقدار آن را ارائه می دهید.
- شناسه مشتری: Health Connect شناسه های مشتری را ارائه می دهد تا برنامه های مشتری بتوانند با استفاده از شناسه های خود به داده ها مراجعه کنند، که به حل تعارض کمک می کند و همگام سازی را آسان تر می کند. این به صورت دستی به رکورد ارائه می شود.
- نسخه رکورد مشتری: همراه با شناسه مشتری، Health Connect برای کمک به ردیابی تغییرات در حین همگام سازی داده ها، نسخه سازی را ارائه می دهد. این به صورت دستی به رکورد ارائه می شود.
- روش ضبط: Health Connect به شما امکان می‌دهد نحوه ثبت داده‌ها را درک کنید. این روش ها شامل برنامه هایی است که داده ها را به صورت غیرفعال (به طور خودکار) ضبط می کنند و کاربرانی که داده ها را به صورت فعال یا دستی ضبط می کنند.
شناسه اتصال سلامت
Health Connect شناسه‌های منحصربه‌فرد (UID) را به اشیاء داده‌ای که به تازگی درج شده‌اند اختصاص می‌دهد، که اشیاء داده را شناسایی کرده و آنها را از دیگران متمایز می‌کند. شناسه‌های Health Connect در درخواست‌های خواندن یا نوشتن مفید هستند. شناسه‌های Health Connect با شناسه‌های مشتری یکسان نیستند. یک برنامه مشتری شناسه های مشتری را اختصاص می دهد، در حالی که Health Connect منحصراً شناسه های Health Connect را اختصاص می دهد.
هنگام کار با Health Connect ID نکات زیر را در نظر داشته باشید :
- Session ها یک شناسه Health Connect دارند، اما داده های درون جلسات شناسه Health Connect مخصوص به خود را دارند.
- شناسه‌های Health Connect مرتبط یا مرتبط با مهر زمانی نیستند.
- برخی موارد استفاده ممکن است نیاز به ذخیره شناسه Health Connect خاص در طول یک گردش کار داشته باشند. به عنوان مثال، یک شناسه خاص برای بازیابی و نشان دادن ورودی داده‌ای که کاربر به تازگی ثبت کرده است، مورد نیاز است.
زمان در Health Connect
همه داده های نوشته شده در Health Connect باید اطلاعات منطقه افست را مشخص کنند. تعیین منطقه افست به برنامه‌ها امکان می‌دهد داده‌ها را برای نمایش آن در زمان مدنی بخوانند. زمان مدنی زمانی است که محلی و مربوط به کاربر است، اما لزوماً در زمان هماهنگ جهانی (UTC) نیست.
در شرایط نادر، منطقه افست ممکن است در دسترس نباشد. هنگامی که این اتفاق در Android 14 (سطح API 34) رخ می‌دهد، Health Connect بر اساس منطقه زمانی پیش‌فرض سیستم، افست منطقه را تنظیم می‌کند. در اندروید 13 و نسخه‌های پایین‌تر (سطح API 33 و پایین‌تر)، می‌توان به Health Connect بدون مشخص کردن اطلاعات افست ناحیه‌ای نوشت، که در صورت امکان باید از آن اجتناب کرد.
تنظیم زمان و منطقه
مشخص کردن اطلاعات افست منطقه هنگام نوشتن داده، اطلاعات منطقه زمانی را هنگام خواندن داده ها در Health Connect ارائه می دهد. با این حال، ممکن است این کار را در شرایط خاصی انجام ندهد، مانند زمانی که منطقه افست ارائه نشده است. برنامه شما باید برای مقابله با هر دو نوع داده آماده باشد، به نحوی که برای شرایط خاص شما منطقی باشد.
مجوزها
قبل از درخواست هر گونه مجوز، برنامه شما باید ابتدا آنها را در مانیفست اعلام کند. برای نگاشت کامل انواع داده ها و مجوزهای آنها به جداول زیر مراجعه کنید.
برای 1.0.0-alpha10 و بالاتر
| ضبط نوع کلاس | خواندن و نوشتن اعلامیه مجوز |
|---|---|
| ActiveCalories Burned | android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| دمای پایه بدن | android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
| میزان متابولیسم پایه | android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE |
| گلوکز خون | android.permission.health.READ_BLOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| فشار خون | android.permission.health.READ_BLOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE |
| چربی بدن | android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| دمای بدن | android.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
| توده آب بدن | 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 |
| ElevationGained | android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED |
| جلسه تمرین | 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 |
| قاعدگی جریان | 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 |
| Resting HeartRate | 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 |
| Sleep Session | android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP |
| سرعت | android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED |
| StepsCadence | 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 و پایین تر
| ضبط نوع کلاس | خواندن و نوشتن اعلامیه مجوز |
|---|---|
| ActiveCalories Burned | androidx.health.permission.ActiveCaloriesBurned.READ androidx.health.permission.ActiveCaloriesBurned.WRITE |
| دمای پایه بدن | androidx.health.permission.BasalBodyTemperature.READ androidx.health.permission.BasalBodyTemperature.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 |
| چربی بدن | androidx.health.permission.BodyFat.READ androidx.health.permission.BodyFat.WRITE |
| دمای بدن | androidx.health.permission.BodyTemperature.READ androidx.health.permission.BodyTemperature.WRITE |
| توده آب بدن | androidx.health.permission.BodyWaterMass.READ androidx.health.permission.BodyWaterMass.WRITE |
| BoneMass | androidx.health.permission.BoneMass.READ androidx.health.permission.BoneMass.WRITE |
| مخاط دهانه رحم | androidx.health.permission.CervicalMucus.READ androidx.health.permission.CervicalMucus.WRITE |
| CyclingPedalingCadence | androidx.health.permission.CyclingPedalingCadence.READ androidx.health.permission.CyclingPedalingCadence.WRITE |
| فاصله | androidx.health.permission.Distance.READ androidx.health.permission.Distance.WRITE |
| ElevationGained | androidx.health.permission.ElevationGained.READ androidx.health.permission.ElevationGained.WRITE |
| جلسه تمرین | 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 |
| قاعدگی جریان | 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.Oxygen Saturation.READ androidx.health.permission.Oxygen Saturation.WRITE |
| قدرت | androidx.health.permission.Power.READ androidx.health.permission.Power.WRITE |
| میزان تنفس | androidx.health.permission.RespiratoryRate.READ androidx.health.permission.RespiratoryRate.WRITE |
| Resting HeartRate | androidx.health.permission.RestingHeartRate.READ androidx.health.permission.RestingHeartRate.WRITE |
| فعالیت جنسی | androidx.health.permission.SexualActivity.READ androidx.health.permission.SexualActivity.WRITE |
| Sleep Session | androidx.health.permission.SleepSession.READ androidx.health.permission.SleepSession.WRITE |
| سرعت | androidx.health.permission.Speed.READ androidx.health.permission.Speed.WRITE |
| StepsCadence | 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.WheelchairPushes.READ androidx.health.permission.WheelchairPushes.WRITE |
انواع داده ها و مجوزهای خود را بررسی کنید
اکنون که انواع داده ها و مجوزهای خود را برنامه ریزی کرده اید، می توانید آنها را در طول توسعه پیاده سازی کنید.
وقتی برنامه خود را قبل از آپلود در فروشگاه Play مرور می‌کنید، فهرست انواع داده‌ها و مجوزهایی را که برنامه شما به آن نیاز دارد دوباره بررسی کنید. این به شما امکان می دهد میزان استفاده از داده های برنامه خود را به طور دقیق اعلام کنید .
هنگامی که برای انتشار برنامه خود در فروشگاه Play آماده می شوید، دسترسی به انواع داده Health Connect را که برنامه شما استفاده می کند، اعلام کنید . در غیر این صورت، ممکن است از کاربران پیام خطایی دریافت شود که در آن برنامه شما نمی‌تواند به انواع داده‌های Health Connect دسترسی داشته باشد زیرا به تأیید خاصی نیاز دارند.