Health Connect lưu trữ và sắp xếp cả dữ liệu về sức khoẻ và hoạt động thể chất cũng như dữ liệu hồ sơ y tế. Điều quan trọng là trước tiên bạn phải hiểu rõ những loại dữ liệu và quyền mà Health Connect cung cấp để có thể lên kế hoạch cho các yêu cầu của ứng dụng.
Sau khi phát triển, khi chuẩn bị xuất bản ứng dụng lên Cửa hàng Play, bạn phải khai báo việc sử dụng dữ liệu của ứng dụng cũng như khai báo quyền truy cập vào các loại dữ liệu Health Connect mà ứng dụng của bạn sử dụng. Nếu không, người dùng có thể nhận được thông báo lỗi cho biết ứng dụng của bạn không thể truy cập vào các loại dữ liệu của Health Connect vì các loại dữ liệu này yêu cầu có sự phê duyệt đặc biệt.
Hãy xem bài viết Hoàn tất biểu mẫu khai báo ứng dụng sức khoẻ trong Play Console để biết thêm thông tin.
Danh mục loại dữ liệu
Health Connect hỗ trợ các loại dữ liệu được dùng trên hầu hết các ứng dụng về sức khoẻ và thể chất để cung cấp nhiều loại dữ liệu nhất có thể. Mục đích của Health Connect là cung cấp bộ nhớ lưu trữ và một cái nhìn toàn diện về dữ liệu sức khoẻ cũng như dữ liệu về hoạt động thể dục. Các loại dữ liệu này thuộc các danh mục sau:
| Danh mục | Mô tả | |
|---|---|---|
| directions_run | Hoạt động | Mục này ghi lại mọi hoạt động người dùng thực hiện. Dữ liệu này có thể bao gồm các hoạt động về sức khoẻ và thể chất như chạy và bơi. |
| làm thẳng | Số đo cơ thể | Mục này thu thập dữ liệu chung liên quan đến cơ thể, chẳng hạn như cân nặng và tỷ lệ trao đổi chất cơ bản của người dùng. |
| màu mỡ | Theo dõi chu kỳ kinh nguyệt | Tính năng này ghi lại chu kỳ kinh nguyệt và các điểm dữ liệu liên quan, chẳng hạn như kết quả nhị phân của xét nghiệm rụng trứng. |
| grocery | Nutrition | Mục này thu thập các loại dữ liệu về lượng nước và dinh dưỡng. Phần trước thể hiện lượng nước một người dùng đã uống trong một lần uống. Dữ liệu dinh dưỡng bao gồm các trường tuỳ chọn như lượng calo, đường và magiê. |
| sleep_auto | Ngủ (Sleep) | Dữ liệu này ghi lại dữ liệu khoảng thời gian liên quan đến thời lượng và kiểu ngủ của người dùng. |
| vital_signs | Vitals | Mục này thu thập thông tin cần thiết về sức khoẻ tổng thể của người dùng. Danh mục này bao gồm dữ liệu như nhiệt độ cơ thể, đường huyết, huyết áp và độ bão hoà oxy trong máu. |
| chánh niệm | Sức khoẻ | Mục này thu thập dữ liệu liên quan đến sức khoẻ tinh thần và trạng thái tinh thần của người dùng. |
Trường loại dữ liệu
Bảng loại dữ liệu Health Connect có một số cột trường để giúp bạn hiểu rõ cấu trúc và yêu cầu của từng loại dữ liệu. Các cột này như sau:
| Trường | Mô tả | |
|---|---|---|
| lịch biểu | Loại bản ghi | Cho biết liệu dữ liệu được ghi nhận tại một thời điểm hay trong một khoảng thời gian. Các giá trị có thể là: Interval, Instantaneous, Series. |
| làm thẳng | Đơn vị | Đơn vị đo lường cho loại dữ liệu (ví dụ: Calo, Mét, Số lượng). |
| gắn dấu sao | Trường bắt buộc | Đây là những trường thiết yếu phải có khi ghi dữ liệu cho kiểu dữ liệu này để giúp duy trì tính toàn vẹn của dữ liệu và tính hữu ích. |
Các loại dữ liệu về sức khoẻ và hoạt động thể dục
Trước khi yêu cầu cấp bất kỳ quyền nào, ứng dụng của bạn phải khai báo các quyền đó trong tệp kê khai. Hãy xem phần Khai báo quyền trong Hướng dẫn bắt đầu nhanh để biết thêm thông tin.
Để đọc dữ liệu trong khi ứng dụng ở chế độ nền hoặc để đọc dữ liệu trước đây, bạn phải khai báo một nhóm quyền đọc bổ sung riêng biệt với các quyền đối với loại dữ liệu:
| Quyền đọc bổ sung | Khai báo quyền |
|---|---|
|
Đọc dữ liệu ở chế độ nền
Hướng dẫn về ví dụ đọc ở chế độ nền |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
|
Đọc dữ liệu trước đây
Hướng dẫn đọc dữ liệu cũ hơn 30 ngày |
android.permission.health.READ_HEALTH_DATA_HISTORY |
1. Chọn một phiên bản Jetpack
Thông tin khai báo quyền khác nhau giữa các phiên bản Jetpack, hãy nhớ chọn phạm vi phiên bản Jetpack mà ứng dụng của bạn sử dụng.
2. Lọc bảng kiểu dữ liệu
Bảng sau đây chứa danh sách đầy đủ các loại dữ liệu, mỗi loại có danh mục, cờ tính năng và hướng dẫn, cũng như khai báo quyền.
| Loại dữ liệu Hướng dẫn về tính năng |
Danh mục | Loại bản ghi Khai báo quyền Cờ tính năng |
|---|---|---|
Lượng calo đã đốt cháy khi vận động
|
Hoạt động | ActiveCaloriesBurnedRecord
android.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED Các loại dữ liệu tổng hợpACTIVE_CALORIES_TOTAL |
Cường độ hoạt động
|
Hoạt động | ActivityIntensityRecord
android.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITYCác loại dữ liệu tổng hợpDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
Thân nhiệt cơ bản
|
Theo dõi chu kỳ kinh nguyệt | BasalBodyTemperatureRecord
android.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
Tỷ lệ trao đổi chất cơ bản
|
Số đo cơ thể | BasalMetabolicRateRecord
android.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE Các loại dữ liệu tổng hợpBASAL_CALORIES_TOTAL |
Đường huyết
|
Vitals | BloodGlucoseRecord
android.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
Huyết áp
|
Vitals | BloodPressureRecord
android.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE Các loại dữ liệu tổng hợpDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
Lượng mỡ trong cơ thể
|
Số đo cơ thể | BodyFatRecord
android.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
Thân nhiệt
|
Vitals | BodyTemperatureRecord
android.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
Tổng lượng nước trong cơ thể
|
Số đo cơ thể | BodyWaterMassRecord
android.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
Khối lượng xương
|
Số đo cơ thể | BoneMassRecord
android.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
Dịch nhầy cổ tử cung
|
Theo dõi chu kỳ kinh nguyệt | CervicalMucusRecord
android.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
Nhịp độ đạp xe
|
Hoạt động | CyclingPedalingCadenceRecord
android.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE Các loại dữ liệu tổng hợpRPM_AVGRPM_MAXRPM_MIN |
Khoảng cách
|
Hoạt động | DistanceRecord
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE Các loại dữ liệu tổng hợpDISTANCE_TOTAL |
Độ cao đạt được
|
Hoạt động | ElevationGainedRecord
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED Các loại dữ liệu tổng hợpELEVATION_GAINED_TOTAL |
| Tập thể dục Hướng dẫn thêm tuyến đường tập thể dục
|
Hoạt động | ExerciseSessionRecord
android.permission.health.READ_EXERCISE android.permission.health.READ_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE android.permission.health.WRITE_EXERCISE_ROUTE Các loại bài tập thể dụcXem tất cả các loại bài tập thể dụcEXERCISE_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_YOGACác loại dữ liệu tổng hợpEXERCISE_DURATION_TOTAL |
Số tầng đã leo
|
Hoạt động | FloorsClimbedRecord
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED Các loại dữ liệu tổng hợpFLOORS_CLIMBED_TOTAL |
Tần số tim
|
Vitals | HeartRateRecord
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE Các loại dữ liệu tổng hợpBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
Sự thay đổi tần số tim
|
Vitals | HeartRateVariabilityRmssdRecord
android.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
Chiều cao
|
Số đo cơ thể | HeightRecord
android.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT Các loại dữ liệu tổng hợpHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
Hydration
|
Dinh dưỡng | HydrationRecord
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION Các loại dữ liệu tổng hợpVOLUME_TOTAL |
Chảy máu giữa chu kỳ kinh nguyệt
|
Theo dõi chu kỳ kinh nguyệt | IntermenstrualBleedingRecord
android.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
Khối lượng cơ thể trừ chất béo
|
Số đo cơ thể | LeanBodyMassRecord
android.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| Menstruation Đối với MenstruationFlowRecord:
Đối với MenstruationPeriodRecord:
|
Theo dõi chu kỳ kinh nguyệt | MenstruationFlowRecord
MenstruationPeriodRecord
android.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| Chánh niệm Hướng dẫn theo dõi chánh niệm
|
Sức khoẻ | MindfulnessSessionRecord
android.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS FEATURE_MINDFULNESS_SESSIONCác loại dữ liệu tổng hợpMINDFULNESS_DURATION_TOTAL |
Dinh dưỡng
|
Dinh dưỡng | NutritionRecord
android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION Các loại dữ liệu tổng hợpBIOTIN_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 |
Que thử rụng trứng
|
Theo dõi chu kỳ kinh nguyệt | OvulationTestRecord
android.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
Độ bão hoà oxy
|
Vitals | OxygenSaturationRecord
android.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| Bài tập theo kế hoạch Hướng dẫn về kế hoạch tập luyện
|
Hoạt động | PlannedExerciseSessionRecord
android.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
Power
|
Hoạt động | PowerRecord
android.permission.health.READ_POWER android.permission.health.WRITE_POWER Các loại dữ liệu tổng hợpPOWER_AVGPOWER_MAXPOWER_MIN |
Nhịp thở
|
Vitals | RespiratoryRateRecord
android.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
Tần số tim lúc nghỉ ngơi
|
Vitals | RestingHeartRateRecord
android.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE Các loại dữ liệu tổng hợpBPM_AVGBPM_MAXBPM_MIN |
Hoạt động tình dục
|
Theo dõi chu kỳ kinh nguyệt | SexualActivityRecord
android.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| Nhiệt độ da Hướng dẫn đo nhiệt độ da
|
Vitals | SkinTemperatureRecord
android.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATURECác loại dữ liệu tổng hợpTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| Giấc ngủ Hướng dẫn theo dõi giấc ngủ
|
Ngủ | SleepSessionRecord
android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP Các loại dữ liệu tổng hợpSLEEP_DURATION_TOTAL |
Tốc độ
|
Hoạt động | SpeedRecord
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED Các loại dữ liệu tổng hợpSPEED_AVGSPEED_MAXSPEED_MIN |
| Các bước Đối với StepsRecord:
Đối với StepsCadenceRecord:
|
Hoạt động | StepsRecord
StepsCadenceRecord
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS Các loại dữ liệu tổng hợp cho StepsRecordCOUNT_TOTALCác loại dữ liệu tổng hợp cho StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
Tổng lượng calo đã đốt cháy
|
Hoạt động | TotalCaloriesBurnedRecord
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED Các loại dữ liệu tổng hợpENERGY_TOTAL |
Tốc độ tiêu thụ oxy tối đa
|
Hoạt động | Vo2MaxRecord
android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
Trọng lượng
|
Số đo cơ thể | WeightRecord
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT Các loại dữ liệu tổng hợpWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
Số lần đẩy xe lăn
|
Hoạt động | WheelchairPushesRecord
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES Các loại dữ liệu tổng hợpCOUNT_TOTAL |