健康数据共享会存储健康与健身数据以及医疗记录数据,并对其进行结构化处理。首先,务必要了解 Health Connect 提供哪些数据类型和权限,以便规划应用的需求。
开发完成后,当您准备将应用发布到 Play 商店时,必须声明应用的数据使用情况,以及声明对应用所使用的 Health Connect 数据类型的访问权限。否则,系统可能会向用户显示一条错误消息,指出您的应用无法访问健康数据共享数据类型,因为这些数据类型需要特殊批准。
如需了解详情,请参阅在 Play 管理中心内填写健康类应用声明。
数据类型类别
健康数据共享支持大多数健康与健身应用中使用的数据类型,旨在尽可能提供多样化的数据。健康数据共享旨在全面展示和存储健康与健身数据。这些数据类型分为以下类别:
| 类别 | 说明 | |
|---|---|---|
| directions_run | activity | 用于捕获用户的所有活动数据,其中可能包括跑步和游泳等健康与健身活动的数据。 | 
| 拉直 | 身体测量数据 | 用于捕获与身体相关的常见数据,例如用户的体重和基础代谢率。 | 
| fertile | 经期记录 | 用于捕获月经周期和相关数据点,例如排卵检测的二元结果。 | 
| 杂货 | Nutrition | 用于捕获饮水量和营养方面的数据。饮水量代表用户单次摄入的水量。营养包含卡路里、糖和镁等可选字段。 | 
| sleep_auto | Sleep | 用于捕获与用户的睡眠时长和类型相关的区间数据。 | 
| vital_signs | Vitals | 用于捕获与用户的整体健康状况相关的重要信息,其中包括体温、血糖、血压和血氧饱和度等数据。 | 
| 正念 | 健康 | 用于捕获与用户的心理健康和福祉相关的数据。 | 
健康和健身数据类型
在请求任何权限之前,您的应用必须先在清单中声明这些权限。如需了解详情,请参阅快速入门指南的声明权限部分。
如需在应用处于后台状态时读取数据,或读取历史数据,必须声明一组额外的读取权限,这些权限与数据类型权限分开声明:
| 额外的读取权限 | 权限声明 | 
|---|---|
| 在后台读取数据 后台读取示例指南 | android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND | 
| 读取历史数据 读取 30 天之前的数据指南 | android.permission.health.READ_HEALTH_DATA_HISTORY | 
1. 选择 Jetpack 版本
不同 Jetpack 版本的权限声明有所不同,请务必选择应用使用的 Jetpack 版本范围。
2. 过滤“数据类型”表格
下表包含完整的数据类型列表,其中每种数据类型都包含类别、功能标志和指南以及权限声明。
| 数据类型 功能指南 | 类别 | 记录类型 权限声明 功能标志 | 
|---|---|---|
| 运动消耗的卡路里数 | activity | ActiveCaloriesBurnedRecordandroid.permission.health.READ_ACTIVE_CALORIES_BURNEDandroid.permission.health.WRITE_ACTIVE_CALORIES_BURNED | 
| 活动强度 | activity | ActivityIntensityRecordandroid.permission.health.READ_ACTIVITY_INTENSITYandroid.permission.health.WRITE_ACTIVITY_INTENSITYFEATURE_ACTIVITY_INTENSITY | 
| 基础体温 | 经期记录 | BasalBodyTemperatureRecordandroid.permission.health.READ_BASAL_BODY_TEMPERATUREandroid.permission.health.WRITE_BASAL_BODY_TEMPERATURE | 
| 基础代谢率 | 身体测量数据 | BasalMetabolicRateRecordandroid.permission.health.READ_BASAL_METABOLIC_RATEandroid.permission.health.WRITE_BASAL_METABOLIC_RATE | 
| 血糖 | 生命体征 | BloodGlucoseRecordandroid.permission.health.READ_BLOOD_GLUCOSEandroid.permission.health.WRITE_BLOOD_GLUCOSE | 
| 血压 | 生命体征 | BloodPressureRecordandroid.permission.health.READ_BLOOD_PRESSUREandroid.permission.health.WRITE_BLOOD_PRESSURE | 
| 体脂 | 身体测量数据 | BodyFatRecordandroid.permission.health.READ_BODY_FATandroid.permission.health.WRITE_BODY_FAT | 
| 体温 | 生命体征 | BodyTemperatureRecordandroid.permission.health.READ_BODY_TEMPERATUREandroid.permission.health.WRITE_BODY_TEMPERATURE | 
| 身体含水量 | 身体测量数据 | BodyWaterMassRecordandroid.permission.health.READ_BODY_WATER_MASSandroid.permission.health.WRITE_BODY_WATER_MASS | 
| 骨质密度 | 身体测量数据 | BoneMassRecordandroid.permission.health.READ_BONE_MASSandroid.permission.health.WRITE_BONE_MASS | 
| 宫颈粘液 | 经期记录 | CervicalMucusRecordandroid.permission.health.READ_CERVICAL_MUCUSandroid.permission.health.WRITE_CERVICAL_MUCUS | 
| 骑车踩踏频率 | activity | CyclingPedalingCadenceRecordandroid.permission.health.READ_EXERCISEandroid.permission.health.WRITE_EXERCISE | 
| 距离 | activity | DistanceRecordandroid.permission.health.READ_DISTANCEandroid.permission.health.WRITE_DISTANCE | 
| 爬升高度 | activity | ElevationGainedRecordandroid.permission.health.READ_ELEVATION_GAINEDandroid.permission.health.WRITE_ELEVATION_GAINED | 
| 锻炼图标 添加锻炼路线指南 | activity | ExerciseSessionRecordandroid.permission.health.READ_EXERCISEandroid.permission.health.READ_EXERCISE_ROUTEandroid.permission.health.WRITE_EXERCISEandroid.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 | 
| 爬楼层数 | activity | FloorsClimbedRecordandroid.permission.health.READ_FLOORS_CLIMBEDandroid.permission.health.WRITE_FLOORS_CLIMBED | 
| 心率 | 生命体征 | HeartRateRecordandroid.permission.health.READ_HEART_RATEandroid.permission.health.WRITE_HEART_RATE | 
| 心率变异性 | 生命体征 | HeartRateVariabilityRmssdRecordandroid.permission.health.READ_HEART_RATE_VARIABILITYandroid.permission.health.WRITE_HEART_RATE_VARIABILITY | 
| 高度 | 身体测量数据 | HeightRecordandroid.permission.health.READ_HEIGHTandroid.permission.health.WRITE_HEIGHT | 
| Hydration | 营养 | HydrationRecordandroid.permission.health.READ_HYDRATIONandroid.permission.health.WRITE_HYDRATION | 
| 经间期出血 | 经期记录 | IntermenstrualBleedingRecordandroid.permission.health.READ_INTERMENSTRUAL_BLEEDINGandroid.permission.health.WRITE_INTERMENSTRUAL_BLEEDING | 
| 净体重 | 身体测量数据 | LeanBodyMassRecordandroid.permission.health.READ_LEAN_BODY_MASSandroid.permission.health.WRITE_LEAN_BODY_MASS | 
| 月经 | 经期记录 | MenstruationFlowRecordMenstruationPeriodRecordandroid.permission.health.READ_MENSTRUATIONandroid.permission.health.WRITE_MENSTRUATION | 
| 正念 跟踪正念指南 | 健康 | MindfulnessSessionRecordandroid.permission.health.READ_MINDFULNESSandroid.permission.health.WRITE_MINDFULNESSFEATURE_MINDFULNESS_SESSION | 
| 营养 | 营养 | NutritionRecordandroid.permission.health.READ_NUTRITIONandroid.permission.health.WRITE_NUTRITION | 
| 排卵期测试 | 经期记录 | OvulationTestRecordandroid.permission.health.READ_OVULATION_TESTandroid.permission.health.WRITE_OVULATION_TEST | 
| 血氧饱和度 | 生命体征 | OxygenSaturationRecordandroid.permission.health.READ_OXYGEN_SATURATIONandroid.permission.health.WRITE_OXYGEN_SATURATION | 
| 计划锻炼 训练计划指南 | activity | PlannedExerciseSessionRecordandroid.permission.health.READ_PLANNED_EXERCISEandroid.permission.health.WRITE_PLANNED_EXERCISEFEATURE_PLANNED_EXERCISE | 
| 电源 | activity | PowerRecordandroid.permission.health.READ_POWERandroid.permission.health.WRITE_POWER | 
| 呼吸频率 | 生命体征 | RespiratoryRateRecordandroid.permission.health.READ_RESPIRATORY_RATEandroid.permission.health.WRITE_RESPIRATORY_RATE | 
| 静息心率 | 生命体征 | RestingHeartRateRecordandroid.permission.health.READ_RESTING_HEART_RATEandroid.permission.health.WRITE_RESTING_HEART_RATE | 
| 性行为 | activity | SexualActivityRecordandroid.permission.health.READ_SEXUAL_ACTIVITYandroid.permission.health.WRITE_SEXUAL_ACTIVITY | 
| 体表温度 测量体表温度指南 | 生命体征 | SkinTemperatureRecordandroid.permission.health.READ_SKIN_TEMPERATUREandroid.permission.health.WRITE_SKIN_TEMPERATUREFEATURE_SKIN_TEMPERATURE | 
| 睡眠时段 “追踪睡眠时段”指南 | 睡眠 | SleepSessionRecordandroid.permission.health.READ_SLEEPandroid.permission.health.WRITE_SLEEP | 
| 速度 | activity | SpeedRecordandroid.permission.health.READ_SPEEDandroid.permission.health.WRITE_SPEED | 
| 步骤 | activity | StepsRecordStepsCadenceRecordandroid.permission.health.READ_STEPSandroid.permission.health.WRITE_STEPS | 
| 消耗的总卡路里数 | activity | TotalCaloriesBurnedRecordandroid.permission.health.READ_TOTAL_CALORIES_BURNEDandroid.permission.health.WRITE_TOTAL_CALORIES_BURNED | 
| 最大摄氧量 | activity | Vo2MaxRecordandroid.permission.health.READ_VO2_MAXandroid.permission.health.WRITE_VO2_MAX | 
| Weight | 身体测量数据 | WeightRecordandroid.permission.health.READ_WEIGHTandroid.permission.health.WRITE_WEIGHT | 
| 推轮椅次数 | activity | WheelchairPushesRecordandroid.permission.health.READ_WHEELCHAIR_PUSHESandroid.permission.health.WRITE_WHEELCHAIR_PUSHES | 
