健康数据共享会存储健康与健身数据以及医疗记录数据,并对其进行结构化处理。首先,务必要了解 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_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| 活动强度 |
activity |
ActivityIntensityRecordandroid.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITY |
| 基础体温 |
经期记录 |
BasalBodyTemperatureRecordandroid.permission.health.READ_BASAL_BODY_TEMPERATURE android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
| 基础代谢率 |
身体测量数据 |
BasalMetabolicRateRecordandroid.permission.health.READ_BASAL_METABOLIC_RATE android.permission.health.WRITE_BASAL_METABOLIC_RATE |
| 血糖 |
生命体征 |
BloodGlucoseRecordandroid.permission.health.READ_BLOOD_GLUCOSE android.permission.health.WRITE_BLOOD_GLUCOSE |
| 血压 |
生命体征 |
BloodPressureRecordandroid.permission.health.READ_BLOOD_PRESSURE android.permission.health.WRITE_BLOOD_PRESSURE |
| 体脂 |
身体测量数据 |
BodyFatRecordandroid.permission.health.READ_BODY_FAT android.permission.health.WRITE_BODY_FAT |
| 体温 |
生命体征 |
BodyTemperatureRecordandroid.permission.health.READ_BODY_TEMPERATURE android.permission.health.WRITE_BODY_TEMPERATURE |
| 身体含水量 |
身体测量数据 |
BodyWaterMassRecordandroid.permission.health.READ_BODY_WATER_MASS android.permission.health.WRITE_BODY_WATER_MASS |
| 骨质密度 |
身体测量数据 |
BoneMassRecordandroid.permission.health.READ_BONE_MASS android.permission.health.WRITE_BONE_MASS |
| 宫颈粘液 |
经期记录 |
CervicalMucusRecordandroid.permission.health.READ_CERVICAL_MUCUS android.permission.health.WRITE_CERVICAL_MUCUS |
| 骑车踩踏频率 |
activity |
CyclingPedalingCadenceRecordandroid.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE |
| 距离 |
activity |
DistanceRecordandroid.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE |
| 爬升高度 |
activity |
ElevationGainedRecordandroid.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED |
| 锻炼图标 添加锻炼路线指南 |
activity |
ExerciseSessionRecordandroid.permission.health.READ_EXERCISE android.permission.health.READ_EXERCISE_ROUTE android.permission.health.WRITE_EXERCISE android.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_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED |
| 心率 |
生命体征 |
HeartRateRecordandroid.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE |
| 心率变异性 |
生命体征 |
HeartRateVariabilityRmssdRecordandroid.permission.health.READ_HEART_RATE_VARIABILITY android.permission.health.WRITE_HEART_RATE_VARIABILITY |
| 高度 |
身体测量数据 |
HeightRecordandroid.permission.health.READ_HEIGHT android.permission.health.WRITE_HEIGHT |
| Hydration |
营养 |
HydrationRecordandroid.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION |
| 经间期出血 |
经期记录 |
IntermenstrualBleedingRecordandroid.permission.health.READ_INTERMENSTRUAL_BLEEDING android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING |
| 净体重 |
身体测量数据 |
LeanBodyMassRecordandroid.permission.health.READ_LEAN_BODY_MASS android.permission.health.WRITE_LEAN_BODY_MASS |
| 月经 |
经期记录 |
MenstruationFlowRecordMenstruationPeriodRecordandroid.permission.health.READ_MENSTRUATION android.permission.health.WRITE_MENSTRUATION |
| 正念 跟踪正念指南 |
健康 |
MindfulnessSessionRecordandroid.permission.health.READ_MINDFULNESS android.permission.health.WRITE_MINDFULNESS FEATURE_MINDFULNESS_SESSION |
| 营养 |
营养 |
NutritionRecordandroid.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION |
| 排卵期测试 |
经期记录 |
OvulationTestRecordandroid.permission.health.READ_OVULATION_TEST android.permission.health.WRITE_OVULATION_TEST |
| 血氧饱和度 |
生命体征 |
OxygenSaturationRecordandroid.permission.health.READ_OXYGEN_SATURATION android.permission.health.WRITE_OXYGEN_SATURATION |
| 计划锻炼 训练计划指南 |
activity |
PlannedExerciseSessionRecordandroid.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
| 电源 |
activity |
PowerRecordandroid.permission.health.READ_POWER android.permission.health.WRITE_POWER |
| 呼吸频率 |
生命体征 |
RespiratoryRateRecordandroid.permission.health.READ_RESPIRATORY_RATE android.permission.health.WRITE_RESPIRATORY_RATE |
| 静息心率 |
生命体征 |
RestingHeartRateRecordandroid.permission.health.READ_RESTING_HEART_RATE android.permission.health.WRITE_RESTING_HEART_RATE |
| 性行为 |
activity |
SexualActivityRecordandroid.permission.health.READ_SEXUAL_ACTIVITY android.permission.health.WRITE_SEXUAL_ACTIVITY |
| 体表温度 测量体表温度指南 |
生命体征 |
SkinTemperatureRecordandroid.permission.health.READ_SKIN_TEMPERATURE android.permission.health.WRITE_SKIN_TEMPERATURE FEATURE_SKIN_TEMPERATURE |
| 睡眠时段 “追踪睡眠时段”指南 |
睡眠 |
SleepSessionRecordandroid.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP |
| 速度 |
activity |
SpeedRecordandroid.permission.health.READ_SPEED android.permission.health.WRITE_SPEED |
| 步骤 |
activity |
StepsRecordStepsCadenceRecordandroid.permission.health.READ_STEPS android.permission.health.WRITE_STEPS |
| 消耗的总卡路里数 |
activity |
TotalCaloriesBurnedRecordandroid.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
| 最大摄氧量 |
activity |
Vo2MaxRecordandroid.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
| Weight |
身体测量数据 |
WeightRecordandroid.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT |
| 推轮椅次数 |
activity |
WheelchairPushesRecordandroid.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES |