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 Google 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.
Để biết thêm thông tin, hãy xem phần Hoàn tất biểu mẫu khai báo ứng dụng sức khoẻ trong Play Console.
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. |
| straighten | 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. |
| fertile | 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 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. |
| mindfulness | 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. |
Hướng dẫn về trải nghiệm của nhà phát triển
Health Connect cung cấp các hướng dẫn về trải nghiệm của nhà phát triển, tập trung vào các trường hợp sử dụng cụ thể liên quan đến sức khoẻ và thể chất. Các hướng dẫn này cho bạn biết cách sử dụng các kiểu dữ liệu có liên quan với nhau để tạo các tính năng cho những lĩnh vực sau:
Bảng kiểu dữ liệu sau đây cũng cho biết những hướng dẫn trải nghiệm nào được liên kết với từng kiểu dữ liệu.
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ả | |
|---|---|---|
| schedule | Loại bản ghi | Cho biết 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. |
| straighten | Đơn vị | Đơn vị đo lường cho loại dữ liệu (ví dụ: Calo, Mét, Số lượng). |
| star | 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à 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. Để biết thêm thông tin, hãy xem phần Khai báo quyền trong hướng dẫn bắt đầu nhanh.
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.
Bảng này dành cho Health Connect SDK phiên bản 1.0.0-alpha09 trở xuống. Nếu bạn đang sử dụng phiên bản SDK cao hơn, hãy xem Các kiểu dữ liệu Health Connect cho SDK 1.0.0-alpha10 trở lên.
| Loại dữ liệu Hướng dẫn |
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 Hướng dẫn về các bài tập
|
Hoạt động | ActiveCaloriesBurnedRecord
androidx.health.permission.ActiveCaloriesBurned.READ androidx.health.permission.ActiveCaloriesBurned.WRITE Các loại dữ liệu tổng hợpACTIVE_CALORIES_TOTAL |
| Cường độ hoạt động Hướng dẫn về bài tập
|
Hoạt động | ActivityIntensityRecord
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
androidx.health.permission.BasalBodyTemperature.READ androidx.health.permission.BasalBodyTemperature.WRITE |
Tỷ lệ trao đổi chất cơ bản
|
Số đo cơ thể | BasalMetabolicRateRecord
androidx.health.permission.BasalMetabolicRate.READ androidx.health.permission.BasalMetabolicRate.WRITE Các loại dữ liệu tổng hợpBASAL_CALORIES_TOTAL |
| Đường huyết Hướng dẫn về
|
Vitals | BloodGlucoseRecord
androidx.health.permission.BloodGlucose.READ androidx.health.permission.BloodGlucose.WRITE |
| Huyết áp Hướng dẫn về chỉ số sức khỏe
|
Vitals | BloodPressureRecord
androidx.health.permission.BloodPressure.READ androidx.health.permission.BloodPressure.WRITE 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
androidx.health.permission.BodyFat.READ androidx.health.permission.BodyFat.WRITE |
| Nhiệt độ cơ thể Hướng dẫn về các chỉ số sức khỏe
|
Vitals | BodyTemperatureRecord
androidx.health.permission.BodyTemperature.READ androidx.health.permission.BodyTemperature.WRITE |
Tổng lượng nước trong cơ thể
|
Số đo cơ thể | BodyWaterMassRecord
androidx.health.permission.BodyWaterMass.READ androidx.health.permission.BodyWaterMass.WRITE |
Khối lượng xương
|
Số đo cơ thể | BoneMassRecord
androidx.health.permission.BoneMass.READ androidx.health.permission.BoneMass.WRITE |
Dịch nhầy cổ tử cung
|
Theo dõi chu kỳ kinh nguyệt | CervicalMucusRecord
androidx.health.permission.CervicalMucus.READ androidx.health.permission.CervicalMucus.WRITE |
| Nhịp đạp xe Hướng dẫn về bài tập
|
Hoạt động | CyclingPedalingCadenceRecord
androidx.health.permission.Exercise.READ androidx.health.permission.Exercise.WRITE Các loại dữ liệu tổng hợpRPM_AVGRPM_MAXRPM_MIN |
| Khoảng cách Hướng dẫn về các bài tập
|
Hoạt động | DistanceRecord
androidx.health.permission.Distance.READ androidx.health.permission.Distance.WRITE Các loại dữ liệu tổng hợpDISTANCE_TOTAL |
| Độ cao đạt được Hướng dẫn về hoạt động thể dục
|
Hoạt động | ElevationGainedRecord
androidx.health.permission.ElevationGained.READ androidx.health.permission.ElevationGained.WRITE Các loại dữ liệu tổng hợpELEVATION_GAINED_TOTAL |
| Tập thể dục Hướng dẫn về các bài tập Hướng dẫn cách thêm tuyến đường tập thể dục
|
Hoạt động | ExerciseSessionRecord
androidx.health.permission.ExerciseSession.READ androidx.health.permission.ExerciseSession.WRITE Các loại bài tập thể dụcXem tất cả các loại bài tậpEXERCISE_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 Hướng dẫn về chế độ tập luyện
|
Hoạt động | FloorsClimbedRecord
androidx.health.permission.FloorsClimbed.READ androidx.health.permission.FloorsClimbed.WRITE Các loại dữ liệu tổng hợpFLOORS_CLIMBED_TOTAL |
| Tần số tim Hướng dẫn về các chỉ số sức khỏe
|
Vitals | HeartRateRecord
androidx.health.permission.HeartRate.READ androidx.health.permission.HeartRate.WRITE Các loại dữ liệu tổng hợpBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| Độ biến thiên nhịp tim Hướng dẫn về Android vitals
|
Vitals | HeartRateVariabilityRmssdRecord
androidx.health.permission.HeartRateVariability.READ androidx.health.permission.HeartRateVariability.WRITE |
Chiều cao
|
Số đo cơ thể | HeightRecord
androidx.health.permission.Height.READ androidx.health.permission.Height.WRITE Các loại dữ liệu tổng hợpHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
Hydration
|
Dinh dưỡng | HydrationRecord
androidx.health.permission.Hydration.READ androidx.health.permission.Hydration.WRITE 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
androidx.health.permission.IntermenstrualBleeding.READ androidx.health.permission.IntermenstrualBleeding.WRITE |
Khối lượng cơ thể trừ chất béo
|
Số đo cơ thể | LeanBodyMassRecord
androidx.health.permission.LeanBodyMass.READ androidx.health.permission.LeanBodyMass.WRITE |
| Menstruation Đối với MenstruationFlowRecord:
Đối với MenstruationPeriodRecord:
|
Theo dõi chu kỳ kinh nguyệt | MenstruationFlowRecord
MenstruationPeriodRecord
androidx.health.permission.Menstruation.READ androidx.health.permission.Menstruation.WRITE |
| Chánh niệm Hướng dẫn theo dõi hoạt động chánh niệm
|
Sức khoẻ | MindfulnessSessionRecord
FEATURE_MINDFULNESS_SESSIONCác loại buổi tập chánh niệmXem tất cả các loại buổi tập chánh niệmMINDFULNESS_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDEDCác loại dữ liệu tổng hợpMINDFULNESS_DURATION_TOTAL |
Dinh dưỡng
|
Dinh dưỡng | NutritionRecord
androidx.health.permission.Nutrition.READ androidx.health.permission.Nutrition.WRITE 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
androidx.health.permission.OvulationTest.READ androidx.health.permission.OvulationTest.WRITE |
| Độ bão hoà oxy Hướng dẫn về các chỉ số quan trọng
|
Vitals | OxygenSaturationRecord
androidx.health.permission.OxygenSaturation.READ androidx.health.permission.OxygenSaturation.WRITE |
| Bài tập theo kế hoạch Hướng dẫn về bài tập Hướng dẫn về kế hoạch tập luyện
|
Hoạt động | PlannedExerciseSessionRecord
androidx.health.permission.PlannedExerciseSession.READ androidx.health.permission.PlannedExerciseSession.WRITE FEATURE_PLANNED_EXERCISE |
| Power Hướng dẫn về bài tập
|
Hoạt động | PowerRecord
androidx.health.permission.Power.READ androidx.health.permission.Power.WRITE Các loại dữ liệu tổng hợpPOWER_AVGPOWER_MAXPOWER_MIN |
| Nhịp thở Hướng dẫn về
|
Vitals | RespiratoryRateRecord
androidx.health.permission.RespiratoryRate.READ androidx.health.permission.RespiratoryRate.WRITE |
| Tần số tim lúc nghỉ ngơi Hướng dẫn về các chỉ số sức khỏe
|
Vitals | RestingHeartRateRecord
androidx.health.permission.RestingHeartRate.READ androidx.health.permission.RestingHeartRate.WRITE 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
androidx.health.permission.SexualActivity.READ androidx.health.permission.SexualActivity.WRITE |
| Nhiệt độ trên da Hướng dẫn về các chỉ số quan trọng Hướng dẫn đo nhiệt độ trên da
|
Vitals | SkinTemperatureRecord
FEATURE_SKIN_TEMPERATURECác loại dữ liệu tổng hợpTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| Phiên ngủ Hướng dẫn về tính năng Ngủ Hướng dẫn theo dõi phiên ngủ
|
Ngủ | SleepSessionRecord
androidx.health.permission.SleepSession.READ androidx.health.permission.SleepSession.WRITE Các loại dữ liệu tổng hợpSLEEP_DURATION_TOTAL |
| Tốc độ Hướng dẫn tập luyện
|
Hoạt động | SpeedRecord
androidx.health.permission.Speed.READ androidx.health.permission.Speed.WRITE Các loại dữ liệu tổng hợpSPEED_AVGSPEED_MAXSPEED_MIN |
| Các bước Hướng dẫn về bài tập Đối với StepsRecord:
Đối với StepsCadenceRecord:
|
Hoạt động | StepsRecord
StepsCadenceRecord
androidx.health.permission.Steps.READ androidx.health.permission.Steps.WRITE 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 Hướng dẫn về bài tập
|
Hoạt động | TotalCaloriesBurnedRecord
androidx.health.permission.TotalCaloriesBurned.READ androidx.health.permission.TotalCaloriesBurned.WRITE Các loại dữ liệu tổng hợpENERGY_TOTAL |
| Lượng oxy tối đa (VO2 max) Hướng dẫn về các bài tập
|
Hoạt động | Vo2MaxRecord
androidx.health.permission.VO2Max.READ androidx.health.permission.VO2Max.WRITE |
Trọng lượng
|
Số đo cơ thể | WeightRecord
androidx.health.permission.Weight.READ androidx.health.permission.Weight.WRITE Các loại dữ liệu tổng hợpWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| Số lần đẩy xe lăn Hướng dẫn về
|
Hoạt động | WheelchairPushesRecord
androidx.health.permission.WheelchairPushes.READ androidx.health.permission.WheelchairPushes.WRITE Các loại dữ liệu tổng hợpCOUNT_TOTAL |