Health Connect lưu trữ và sắp xếp cả dữ liệu về sức khoẻ và hoạt động thể dục 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ư thể chất. 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. |
| 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. |
| dễ thụ thai | Theo dõi chu kỳ kinh nguyệt | Mục 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 không bắt buộc 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. |
Các loại dữ liệu về sức khoẻ và 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 |
ActiveCaloriesBurnedRecordandroid.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| Cường độ hoạt động |
Hoạt động |
ActivityIntensityRecordandroid.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITY |
| Thân nhiệt cơ bản |
Theo dõi chu kỳ kinh nguyệt |
BasalBodyTemperatureRecordandroid.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ể |
BasalMetabolicRateRecordandroid.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE |
| Đường huyết |
Vitals |
BloodGlucoseRecordandroid.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| Huyết áp |
Vitals |
BloodPressureRecordandroid.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE |
| Lượng mỡ trong cơ thể |
Số đo cơ thể |
BodyFatRecordandroid.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| Thân nhiệt |
Vitals |
BodyTemperatureRecordandroid.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
| Tổng lượng nước trong cơ thể |
Số đo cơ thể |
BodyWaterMassRecordandroid.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
| Khối lượng xương |
Số đo cơ thể |
BoneMassRecordandroid.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 |
CervicalMucusRecordandroid.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
| Nhịp độ đạp xe |
Hoạt động |
CyclingPedalingCadenceRecordandroid.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE |
| Khoảng cách |
Hoạt động |
DistanceRecordandroid.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE |
| Độ cao đạt được |
Hoạt động |
ElevationGainedRecordandroid.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED |
| Tập thể dục Hướng dẫn thêm tuyến đường tập thể dục |
Hoạt động |
ExerciseSessionRecordandroid.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_YOGA |
| Số tầng đã leo |
Hoạt động |
FloorsClimbedRecordandroid.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED |
| Nhịp tim |
Vitals |
HeartRateRecordandroid.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE |
| Sự thay đổi tần số tim |
Vitals |
HeartRateVariabilityRmssdRecordandroid.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
| Chiều cao |
Số đo cơ thể |
HeightRecordandroid.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT |
| Hydration |
Dinh dưỡng |
HydrationRecordandroid.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION |
| Chảy máu giữa chu kỳ kinh nguyệt |
Theo dõi chu kỳ kinh nguyệt |
IntermenstrualBleedingRecordandroid.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ể |
LeanBodyMassRecordandroid.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| Kinh nguyệt |
Theo dõi chu kỳ kinh nguyệt |
MenstruationFlowRecordMenstruationPeriodRecordandroid.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ẻ |
MindfulnessSessionRecordandroid.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS FEATURE_MINDFULNESS_SESSION |
| Dinh dưỡng |
Dinh dưỡng |
NutritionRecordandroid.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION |
| Que thử rụng trứng |
Theo dõi chu kỳ kinh nguyệt |
OvulationTestRecordandroid.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
| Độ bão hoà oxy |
Vitals |
OxygenSaturationRecordandroid.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 |
PlannedExerciseSessionRecordandroid.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
| Power |
Hoạt động |
PowerRecordandroid.permission.health.READ_POWER android.permission.health.WRITE_POWER |
| Nhịp thở |
Vitals |
RespiratoryRateRecordandroid.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
| Nhịp tim lúc nghỉ ngơi |
Vitals |
RestingHeartRateRecordandroid.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE |
| Hoạt động tình dục |
Hoạt động |
SexualActivityRecordandroid.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| Nhiệt độ trên da Hướng dẫn đo nhiệt độ trên da |
Vitals |
SkinTemperatureRecordandroid.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATURE |
| Lần ngủ Hướng dẫn theo dõi lần ngủ |
Ngủ |
SleepSessionRecordandroid.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP |
| Tốc độ |
Hoạt động |
SpeedRecordandroid.permission.health.READ_SPEED android.permission.health.WRITE_SPEED |
| Các bước |
Hoạt động |
StepsRecordStepsCadenceRecordandroid.permission.health.READ_STEPS android.permission.health.WRITE_STEPS |
| Tổng lượng calo đã đốt cháy |
Hoạt động |
TotalCaloriesBurnedRecordandroid.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
| Tốc độ tiêu thụ oxy tối đa |
Hoạt động |
Vo2MaxRecordandroid.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
| Trọng lượng |
Số đo cơ thể |
WeightRecordandroid.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT |
| Số lần đẩy xe lăn |
Hoạt động |
WheelchairPushesRecordandroid.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES |