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

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

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

如需了解详情，请参阅在 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. 过滤数据类型表格

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

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

  • 记录类型： 间隔
  • 单位： 能量

  • 必填字段

    endTime
    energy
    metadata
    startTime
activity ActiveCaloriesBurnedRecord

android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED

汇总数据类型

ACTIVE_CALORIES_TOTAL
活动强度

  • 记录类型： 间隔

  • 必填字段

    activityIntensityType
    endTime
    metadata
    startTime
activity ActivityIntensityRecord

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

FEATURE_ACTIVITY_INTENSITY

汇总数据类型

DURATION_TOTAL
INTENSITY_MINUTES_TOTAL
MODERATE_DURATION_TOTAL
VIGOROUS_DURATION_TOTAL
基础体温

  • 记录类型： 瞬时
  • 单位： 温度

  • 必填字段

    temperature
    measurementLocation
    metadata
    time
经期记录 BasalBodyTemperatureRecord

android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE

基础代谢率

  • 记录类型： 瞬时
  • 单位： 功率

  • 必填字段

    basalMetabolicRate
    metadata
    time
身体测量数据 BasalMetabolicRateRecord

android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE

汇总数据类型

BASAL_CALORIES_TOTAL
血糖

  • 记录类型： 瞬时

  • 必填字段

    level
    specimenSource
    mealType
    relationToMeal
    metadata
    time
生命体征 BloodGlucoseRecord

android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE

血压

  • 记录类型： 瞬时
  • 单位： 压力

  • 必填字段

    systolic
    diastolic
    bodyPosition
    measurementLocation
    metadata
    time
生命体征 BloodPressureRecord

android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE

汇总数据类型

DIASTOLIC_AVG
DIASTOLIC_MAX
DIASTOLIC_MIN
SYSTOLIC_AVG
SYSTOLIC_MAX
SYSTOLIC_MIN
体脂率

  • 记录类型： 瞬时

  • 必填字段

    percentage
    metadata
    time
身体测量数据 BodyFatRecord

android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT

体温

  • 记录类型： 瞬时
  • 单位： 温度

  • 必填字段

    temperature
    measurementLocation
    metadata
    time
生命体征 BodyTemperatureRecord

android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE

身体含水量

  • 记录类型： 瞬时
  • 单位： 质量

  • 必填字段

    mass
    metadata
    time
身体测量数据 BodyWaterMassRecord

android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS

骨质密度图标

  • 记录类型： 瞬时
  • 单位： 质量

  • 必填字段

    mass
    metadata
    time
身体测量数据 BoneMassRecord

android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS

宫颈粘液

  • 记录类型： 瞬时

  • 必填字段

    appearance
    sensation
    metadata
    time
经期记录 CervicalMucusRecord

android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS

骑车踩踏步频

  • 记录类型： 系列

  • 必填字段

    samples
    endTime
    metadata
    samples
    startTime
activity CyclingPedalingCadenceRecord

android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE

汇总数据类型

RPM_AVG
RPM_MAX
RPM_MIN
距离

  • 记录类型： 间隔
  • 单位： 长度

  • 必填字段

    distance
    endTime
    metadata
    startTime
activity DistanceRecord

android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE

汇总数据类型

DISTANCE_TOTAL
爬升高度

  • 记录类型： 间隔
  • 单位： 长度

  • 必填字段

    elevation
    endTime
    metadata
    startTime
activity ElevationGainedRecord

android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED

汇总数据类型

ELEVATION_GAINED_TOTAL
锻炼

  添加锻炼路线指南
  • 记录类型： 间隔

  • 必填字段

    exerciseType
    endTime
    laps
    metadata
    segments
    startTime
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

汇总数据类型

EXERCISE_DURATION_TOTAL
爬楼层数

  • 记录类型： 间隔

  • 必填字段

    floors
    endTime
    metadata
    startTime
activity FloorsClimbedRecord

android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED

汇总数据类型

FLOORS_CLIMBED_TOTAL
心率

  • 记录类型： 系列

  • 必填字段

    samples
    endTime
    metadata
    startTime
生命体征 HeartRateRecord

android.permission.health.READ_HEART_RATE
android.permission.health.WRITE_HEART_RATE

汇总数据类型

BPM_AVG
BPM_MAX
BPM_MIN
MEASUREMENTS_COUNT
心率变异性

  • 记录类型： 瞬时

  • 必填字段

    heartRateVariabilityMillis
    metadata
    time
生命体征 HeartRateVariabilityRmssdRecord

android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY

身高

  • 记录类型： 瞬时
  • 单位： 长度

  • 必填字段

    height
    metadata
    time
身体测量数据 HeightRecord

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

汇总数据类型

HEIGHT_AVG
HEIGHT_MAX
HEIGHT_MIN
Hydration

  • 记录类型： 间隔
  • 单位： 体积

  • 必填字段

    endTime
    metadata
    startTime
    volume
营养 HydrationRecord

android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION

汇总数据类型

VOLUME_TOTAL
经间期出血

  • 记录类型： 瞬时

  • 必填字段

    metadata
    time
经期记录 IntermenstrualBleedingRecord

android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRITE_INTERMENSTRUAL_BLEEDING

净体重

  • 记录类型： 瞬时
  • 单位： 质量

  • 必填字段

    mass
    metadata
    time
身体测量数据 LeanBodyMassRecord

android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS

月经


对于 MenstruationFlowRecord：
  • 记录类型： 瞬时

  • 必填字段

    flow
    metadata
    time

对于 MenstruationPeriodRecord：
  • 记录类型： 间隔

  • 必填字段

    endTime
    metadata
    startTime
经期记录 MenstruationFlowRecord

MenstruationPeriodRecord

android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION


正念

  正念追踪指南
  • 记录类型： 间隔

  • 必填字段

    endTime
    metadata
    mindfulnessSessionType
    startTime
健康 MindfulnessSessionRecord

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

FEATURE_MINDFULNESS_SESSION

汇总数据类型

MINDFULNESS_DURATION_TOTAL
营养

  • 记录类型： 间隔
  • 单位： 质量

  • 必填字段

    endTime
    mealType
    metadata
    startTime
营养 NutritionRecord

android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION

汇总数据类型

BIOTIN_TOTAL
CAFFEINE_TOTAL
CALCIUM_TOTAL
CHLORIDE_TOTAL
CHOLESTEROL_TOTAL
CHROMIUM_TOTAL
COPPER_TOTAL
DIETARY_FIBER_TOTAL
ENERGY_FROM_FAT_TOTAL
ENERGY_TOTAL
FOLATE_TOTAL
FOLIC_ACID_TOTAL
IODINE_TOTAL
IRON_TOTAL
MAGNESIUM_TOTAL
MANGANESE_TOTAL
MOLYBDENUM_TOTAL
MONOUNSATURATED_FAT_TOTAL
NIACIN_TOTAL
PANTOTHENIC_ACID_TOTAL
PHOSPHORUS_TOTAL
POLYUNSATURATED_FAT_TOTAL
POTASSIUM_TOTAL
PROTEIN_TOTAL
RIBOFLAVIN_TOTAL
SATURATED_FAT_TOTAL
SELENIUM_TOTAL
SODIUM_TOTAL
SUGAR_TOTAL
THIAMIN_TOTAL
TOTAL_CARBOHYDRATE_TOTAL
TOTAL_FAT_TOTAL
TRANS_FAT_TOTAL
UNSATURATED_FAT_TOTAL
VITAMIN_A_TOTAL
VITAMIN_B12_TOTAL
VITAMIN_B6_TOTAL
VITAMIN_C_TOTAL
VITAMIN_D_TOTAL
VITAMIN_E_TOTAL
VITAMIN_K_TOTAL
ZINC_TOTAL
排卵期测试

  • 记录类型： 瞬时

  • 必填字段

    metadata
    result
    time
经期记录 OvulationTestRecord

android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST

血氧饱和度图标

  • 记录类型： 瞬时

  • 必填字段

    metadata
    percentage
    time
生命体征 OxygenSaturationRecord

android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRITE_OXYGEN_SATURATION

有计划的锻炼

  训练计划指南
  • 记录类型： 间隔

  • 必填字段

    block
    endTime
    exerciseType
    hasExplicitTime
    metadata
activity PlannedExerciseSessionRecord

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

FEATURE_PLANNED_EXERCISE
Power

  • 记录类型： 系列

  • 必填字段

    endTime
    samples
    metadata
    startTime
activity PowerRecord

android.permission.health.READ_POWER
android.permission.health.WRITE_POWER

汇总数据类型

POWER_AVG
POWER_MAX
POWER_MIN
呼吸频率

  • 记录类型： 瞬时

  • 必填字段

    metadata
    rate
    time
生命体征 RespiratoryRateRecord

android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE

静息心率

  • 记录类型： 瞬时

  • 必填字段

    beatsPerMinute
    metadata
    time
生命体征 RestingHeartRateRecord

android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRITE_RESTING_HEART_RATE

汇总数据类型

BPM_AVG
BPM_MAX
BPM_MIN
性行为

  • 记录类型： 瞬时

  • 必填字段

    metadata
    protectionUsed
    time
经期记录 SexualActivityRecord

android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY

体表温度

  测量体表温度指南
  • 记录类型： 系列
  • 单位： 温度

  • 必填字段

    deltas
    endTime
    measurementLocation
    metadata
    startTime
生命体征 SkinTemperatureRecord

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

FEATURE_SKIN_TEMPERATURE

汇总数据类型

TEMPERATURE_DELTA_AVG
TEMPERATURE_DELTA_MAX
TEMPERATURE_DELTA_MIN
睡眠时段

  “追踪睡眠时段”指南
  • 记录类型： 间隔

  • 必填字段

    endTime
    metadata
    stages
    startTime
睡眠 SleepSessionRecord

android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP

汇总数据类型

SLEEP_DURATION_TOTAL
速度

  • 记录类型： 系列

  • 必填字段

    endTime
    metadata
    samples
    startTime
activity SpeedRecord

android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED

汇总数据类型

SPEED_AVG
SPEED_MAX
SPEED_MIN
步骤


对于 StepsRecord：
  • 记录类型： 间隔

  • 必填字段

    count
    endTime
    metadata
    startTime

对于 StepsCadenceRecord：
  • 记录类型： 系列

  • 必填字段

    endTime
    samples
    metadata
    startTime
activity StepsRecord

StepsCadenceRecord

android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS

StepsRecord 的汇总数据类型

COUNT_TOTAL

StepsCadenceRecord 的汇总数据类型

RATE_AVG
RATE_MAX
RATE_MIN
消耗卡路里数

  • 记录类型： 间隔
  • 单位： 能量

  • 必填字段

    endTime
    energy
    metadata
    startTime
activity TotalCaloriesBurnedRecord

android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRITE_TOTAL_CALORIES_BURNED

汇总数据类型

ENERGY_TOTAL
最大摄氧量

  • 记录类型： 瞬时

  • 必填字段

    measurementMethod
    metadata
    time
    vo2MillilitersPerMinuteKilogram
activity Vo2MaxRecord

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

权重

  • 记录类型： 瞬时

  • 必填字段

    metadata
    time
    weight
身体测量数据 WeightRecord

android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT

汇总数据类型

WEIGHT_AVG
WEIGHT_MAX
WEIGHT_MIN
推轮椅次数

  • 记录类型： 间隔

  • 必填字段

    count
    endTime
    metadata
    startTime
activity WheelchairPushesRecord

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

汇总数据类型

COUNT_TOTAL