「健康資料同步」資料類型

「健康資料同步」會儲存及建構健康與健身資料和醫療記錄資料。請務必先瞭解 Health Connect 提供的資料類型和權限,再規劃應用程式的需求。

開發完成後,準備將應用程式發布至 Play 商店時,您必須聲明應用程式的資料使用方式,以及聲明應用程式使用的 Health Connect 資料類型存取權。否則,系統可能會向使用者顯示錯誤訊息,指出應用程式無法存取需要特別核准的「健康資料同步」資料類型。

詳情請參閱「在 Play 管理中心完成健康應用程式聲明」。

資料類型類別

Health Connect 支援多數健康與健身應用程式使用的資料類型,盡可能提供多樣化的資料。健康資料同步致力於提供全方位健康與健身資料的總覽與儲存。這些資料類型可分為以下幾類:

表格:健康資料同步資料類型類別
類別 說明
directions_run 活動 擷取使用者進行的任何活動,可以包括各種健康與健身活動,例如跑步和游泳。
拉直 身體測量 擷取與身體相關的常見資料,例如使用者的體重和基礎代謝率。
fertile 週期追蹤 擷取月經週期及相關資料點,例如排卵測試的二元結果。
雜貨 營養 擷取水份和營養資料類型,前者代表使用者一次飲用的水量,後者則有卡路里、糖和鎂等選用欄位。
sleep_auto 睡眠 這會擷取與使用者睡眠時間間隔長度及睡眠類型相關的資料。
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. 篩選資料類型表格

下表完整列出資料類型,並提供各類型的類別、功能旗標和指南,以及權限聲明。

表格:健康資料同步資料類型
資料類型
  功能指南
類別 記錄類型
權限聲明
功能旗標
活動卡路里燃燒量

活動 ActiveCaloriesBurnedRecord

android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED
活動強度

活動 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
單車踩踏頻率

活動 CyclingPedalingCadenceRecord

android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE
距離

活動 DistanceRecord

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

活動 ElevationGainedRecord

android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRITE_ELEVATION_GAINED
運動

  新增運動路線指南
活動 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
爬樓梯數

活動 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
補水

營養 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
Menstruation

經期追蹤 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
預定運動

  訓練計畫指南
活動 PlannedExerciseSessionRecord

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

FEATURE_PLANNED_EXERCISE

Power

活動 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
性活動

活動 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
速度

活動 SpeedRecord

android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED
步數

活動 StepsRecord

StepsCadenceRecord

android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS
卡路里燃燒總量

活動 TotalCaloriesBurnedRecord

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

活動 Vo2MaxRecord

android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX
權重

身體測量資料 WeightRecord

android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT
推輪椅次數

活動 WheelchairPushesRecord

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