健康数据共享会存储健康与健身数据以及医疗记录数据,并对其进行结构化处理。首先,务必要了解 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  |