“健康数据共享”数据类型

健康数据共享会存储健康与健身数据以及医疗记录数据，并对其进行结构化处理。首先，务必要了解 Health Connect 提供哪些数据类型和权限，以便规划应用的需求。

开发完成后，当您准备将应用发布到 Play 商店时，必须声明应用的数据使用情况，以及声明对应用所使用的 Health Connect 数据类型的访问权限。否则，系统可能会向用户显示一条错误消息，指出您的应用无法访问健康数据共享数据类型，因为这些数据类型需要特殊批准。

如需了解详情，请参阅在 Play 管理中心内填写健康类应用声明。

数据类型类别

健康数据共享支持大多数健康与健身应用中使用的数据类型，旨在尽可能提供多样化的数据。健康数据共享旨在全面展示和存储健康与健身数据。这些数据类型分为以下类别：

表：健康数据共享数据类型类别
类别 说明
directions_run activity 用于捕获用户的所有活动数据，其中可能包括跑步和游泳等健康与健身活动的数据。
拉直 身体测量数据 用于捕获与身体相关的常见数据，例如用户的体重和基础代谢率。
fertile 经期记录 用于捕获月经周期和相关数据点，例如排卵检测的二元结果。
杂货 Nutrition 用于捕获饮水量和营养方面的数据。饮水量代表用户单次摄入的水量。营养包含卡路里、糖和镁等可选字段。
sleep_auto Sleep 用于捕获与用户的睡眠时长和类型相关的区间数据。
vital_signs Vitals 用于捕获与用户的整体健康状况相关的重要信息，其中包括体温、血糖、血压和血氧饱和度等数据。
正念 健康 用于捕获与用户的心理健康和福祉相关的数据。

健康和健身数据类型

在请求任何权限之前，您的应用必须先在清单中声明这些权限。如需了解详情，请参阅快速入门指南的声明权限部分。

如需在应用处于后台状态时读取数据，或读取历史数据，必须声明一组额外的读取权限，这些权限与数据类型权限分开声明：

表：Health Connect 数据类型的其他读取权限
额外的读取权限 权限声明
在后台读取数据
  后台读取示例指南 		android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND
读取历史数据
  读取 30 天之前的数据指南 		android.permission.health.READ_HEALTH_DATA_HISTORY

1. 选择 Jetpack 版本

不同 Jetpack 版本的权限声明有所不同，请务必选择应用使用的 Jetpack 版本范围。

2. 过滤“数据类型”表格

下表包含完整的数据类型列表，其中每种数据类型都包含类别、功能标志和指南以及权限声明。

表：健康数据共享数据类型
数据类型
  功能指南		 类别 记录类型
权限声明
功能标志
运动消耗的卡路里数

 activity ActiveCaloriesBurnedRecord

android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED
活动强度

 activity ActivityIntensityRecord

android.permission.health.READ_ACTIVITY_INTENSITY
android.permission.health.WRITE_ACTIVITY_INTENSITY

FEATURE_ACTIVITY_INTENSITY
基础体温

 经期记录 BasalBodyTemperatureRecord

android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE
基础代谢率

 身体测量数据 BasalMetabolicRateRecord

android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE
血糖

 生命体征 BloodGlucoseRecord

android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE
血压

 生命体征 BloodPressureRecord

android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE
体脂

 身体测量数据 BodyFatRecord

android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT
体温

 生命体征 BodyTemperatureRecord

android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE
身体含水量

 身体测量数据 BodyWaterMassRecord

android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS
骨质密度

 身体测量数据 BoneMassRecord

android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS
宫颈粘液

 经期记录 CervicalMucusRecord

android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS
骑车踩踏频率

 activity CyclingPedalingCadenceRecord

android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE
距离

 activity DistanceRecord

android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE
爬升高度

 activity ElevationGainedRecord

android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED
锻炼图标

  添加锻炼路线指南
 activity ExerciseSessionRecord

android.permission.health.READ_EXERCISE
android.permission.health.READ_EXERCISE_ROUTE
android.permission.health.WRITE_EXERCISE
android.permission.health.WRITE_EXERCISE_ROUTE

锻炼类型

查看所有锻炼类型
EXERCISE_TYPE_UNKNOWN
EXERCISE_TYPE_BADMINTON
EXERCISE_TYPE_BASEBALL
EXERCISE_TYPE_BASKETBALL
EXERCISE_TYPE_BIKING
EXERCISE_TYPE_BIKING_STATIONARY
EXERCISE_TYPE_BOOT_CAMP
EXERCISE_TYPE_BOXING
EXERCISE_TYPE_CALISTHENICS
EXERCISE_TYPE_CRICKET
EXERCISE_TYPE_DANCING
EXERCISE_TYPE_ELLIPTICAL
EXERCISE_TYPE_EXERCISE_CLASS
EXERCISE_TYPE_FENCING
EXERCISE_TYPE_FOOTBALL_AMERICAN
EXERCISE_TYPE_FOOTBALL_AUSTRALIAN
EXERCISE_TYPE_FRISBEE_DISC
EXERCISE_TYPE_GOLF
EXERCISE_TYPE_GUIDED_BREATHING
EXERCISE_TYPE_GYMNASTICS
EXERCISE_TYPE_HANDBALL
EXERCISE_TYPE_HIGH_INTENSITY_INTERVAL_TRAINING
EXERCISE_TYPE_HIKING
EXERCISE_TYPE_ICE_HOCKEY
EXERCISE_TYPE_ICE_SKATING
EXERCISE_TYPE_MARTIAL_ARTS
EXERCISE_TYPE_PADDLING
EXERCISE_TYPE_PARAGLIDING
EXERCISE_TYPE_PILATES
EXERCISE_TYPE_RACQUETBALL
EXERCISE_TYPE_ROCK_CLIMBING
EXERCISE_TYPE_ROLLER_HOCKEY
EXERCISE_TYPE_ROWING
EXERCISE_TYPE_ROWING_MACHINE
EXERCISE_TYPE_RUGBY
EXERCISE_TYPE_RUNNING
EXERCISE_TYPE_RUNNING_TREADMILL
EXERCISE_TYPE_SAILING
EXERCISE_TYPE_SCUBA_DIVING
EXERCISE_TYPE_SKATING
EXERCISE_TYPE_SKIING
EXERCISE_TYPE_SNOWBOARDING
EXERCISE_TYPE_SNOWSHOEING
EXERCISE_TYPE_SOCCER
EXERCISE_TYPE_SOFTBALL
EXERCISE_TYPE_SQUASH
EXERCISE_TYPE_STAIR_CLIMBING
EXERCISE_TYPE_STAIR_CLIMBING_MACHINE
EXERCISE_TYPE_STRENGTH_TRAINING
EXERCISE_TYPE_STRETCHING
EXERCISE_TYPE_SURFING
EXERCISE_TYPE_SWIMMING_OPEN_WATER
EXERCISE_TYPE_SWIMMING_POOL
EXERCISE_TYPE_TABLE_TENNIS
EXERCISE_TYPE_TENNIS
EXERCISE_TYPE_VOLLEYBALL
EXERCISE_TYPE_WALKING
EXERCISE_TYPE_WATER_POLO
EXERCISE_TYPE_WEIGHTLIFTING
EXERCISE_TYPE_WHEELCHAIR
EXERCISE_TYPE_OTHER_WORKOUT
EXERCISE_TYPE_YOGA
爬楼层数

 activity FloorsClimbedRecord

android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED
心率

 生命体征 HeartRateRecord

android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE
心率变异性

 生命体征 HeartRateVariabilityRmssdRecord

android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY
高度

 身体测量数据 HeightRecord

android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT
Hydration

 营养 HydrationRecord

android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION
经间期出血

 经期记录 IntermenstrualBleedingRecord

android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING
净体重

 身体测量数据 LeanBodyMassRecord

android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS
月经

 经期记录 MenstruationFlowRecord

MenstruationPeriodRecord

android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION
正念

  跟踪正念指南
 健康 MindfulnessSessionRecord

android.permission.health.READ_MINDFULNESS
android.permission.health.WRITE_MINDFULNESS

FEATURE_MINDFULNESS_SESSION
营养

 营养 NutritionRecord

android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION
排卵期测试

 经期记录 OvulationTestRecord

android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST
血氧饱和度

 生命体征 OxygenSaturationRecord

android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION
计划锻炼

  训练计划指南
 activity PlannedExerciseSessionRecord

android.permission.health.READ_PLANNED_EXERCISE
android.permission.health.WRITE_PLANNED_EXERCISE

FEATURE_PLANNED_EXERCISE
电源

 activity PowerRecord

android.permission.health.READ_POWER
android.permission.health.WRITE_POWER
呼吸频率

 生命体征 RespiratoryRateRecord

android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE
静息心率

 生命体征 RestingHeartRateRecord

android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE
性行为

 activity SexualActivityRecord

android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY
体表温度

  测量体表温度指南
 生命体征 SkinTemperatureRecord

android.permission.health.READ_SKIN_TEMPERATURE
android.permission.health.WRITE_SKIN_TEMPERATURE

FEATURE_SKIN_TEMPERATURE
睡眠时段

  “追踪睡眠时段”指南
 睡眠 SleepSessionRecord

android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP
速度

 activity SpeedRecord

android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED
步骤

 activity StepsRecord

StepsCadenceRecord

android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS
消耗的总卡路里数

 activity TotalCaloriesBurnedRecord

android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED
最大摄氧量

 activity Vo2MaxRecord

android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX
Weight

 身体测量数据 WeightRecord

android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT
推轮椅次数

 activity WheelchairPushesRecord

android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES