健康資料同步資料類型 (SDK 1.0.0-alpha09 以下版本)

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

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

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

資料類型類別

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

表格：健康資料同步資料類型類別
類別 說明
directions_run 活動 擷取使用者進行的任何活動，可以包括各種健康與健身活動，例如跑步和游泳。
straighten 身體測量 擷取與身體相關的常見資料，例如使用者的體重和基礎代謝率。
fertile 週期追蹤 擷取月經週期及相關資料點，例如排卵測試的二元結果。
grocery 營養 擷取水份和營養資料類型，前者代表使用者一次飲用的水量，後者則有卡路里、糖和鎂等選用欄位。
sleep_auto 睡眠 這會擷取與使用者睡眠時間間隔長度及睡眠類型相關的資料。
vital_signs 生理指標 這會擷取關於使用者一般健康的重要資訊。包括體溫、血糖、血壓和血氧濃度等資料。
mindfulness 健康 這會擷取與使用者心理健康和福祉相關的資料。

開發人員體驗指南

「健康資料同步」提供開發人員體驗指南，著重於特定健康與健身用途。這些指南說明如何搭配使用相關資料類型，為下列領域建構功能：

下表也指出哪些體驗指南與各資料類型相關聯。

資料類型欄位

「健康資料同步」資料類型表格包含多個欄位，可協助您瞭解各資料類型的結構和需求。這些資料欄分別是：

表格：資料類型欄位說明
欄位 說明
schedule 記錄類型 指出資料是在特定時間點還是時間間隔內記錄。可能的值包括： 間隔、即時、序列。
straighten 單位 資料類型的測量單位 (例如卡路里、公尺、次數)。
star 必填欄位 這些是為這個資料類型撰寫資料時必須加入的重要欄位，有助於維持資料完整性和實用性。

健康與運動資料類型

要求任何權限之前，應用程式必須先在資訊清單中宣告權限。詳情請參閱快速入門指南的「宣告權限」一節。

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

下表適用於 1.0.0-alpha09 以下版本的健康資料同步 SDK。如果使用較新版本的 SDK，請參閱「適用於 SDK 1.0.0-alpha10 以上版本的健康資料同步資料類型」。

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

  訓練指南
  • 記錄類型： 間隔
  • 單元： 能源

  • 必填欄位

    endTime
    energy
    metadata
    startTime
活動 ActiveCaloriesBurnedRecord

androidx.health.permission.ActiveCaloriesBurned.READ
androidx.health.permission.ActiveCaloriesBurned.WRITE

匯總資料類型

ACTIVE_CALORIES_TOTAL
運動強度

  訓練指南
  • 記錄類型： 間隔

  • 必填欄位

    activityIntensityType
    endTime
    metadata
    startTime
活動 ActivityIntensityRecord


FEATURE_ACTIVITY_INTENSITY

匯總資料類型

DURATION_TOTAL
INTENSITY_MINUTES_TOTAL
MODERATE_DURATION_TOTAL
VIGOROUS_DURATION_TOTAL
基礎體溫

  • 記錄類型： 即時
  • 單位： 溫度

  • 必填欄位

    temperature
    measurementLocation
    metadata
    time
經期追蹤 BasalBodyTemperatureRecord

androidx.health.permission.BasalBodyTemperature.READ
androidx.health.permission.BasalBodyTemperature.WRITE

基礎代謝率

  • 記錄類型： 即時
  • 單位： 電力

  • 必填欄位

    basalMetabolicRate
    metadata
    time
身體測量資料 BasalMetabolicRateRecord

androidx.health.permission.BasalMetabolicRate.READ
androidx.health.permission.BasalMetabolicRate.WRITE

匯總資料類型

BASAL_CALORIES_TOTAL
血糖

  生理指標指南
  • 記錄類型： 即時

  • 必填欄位

    level
    specimenSource
    mealType
    relationToMeal
    metadata
    time
生理指標 BloodGlucoseRecord

androidx.health.permission.BloodGlucose.READ
androidx.health.permission.BloodGlucose.WRITE

血壓

  「健康」應用程式指南
  • 記錄類型： 即時
  • 單位： 壓力

  • 必填欄位

    systolic
    diastolic
    bodyPosition
    measurementLocation
    metadata
    time
生理指標 BloodPressureRecord

androidx.health.permission.BloodPressure.READ
androidx.health.permission.BloodPressure.WRITE

匯總資料類型

DIASTOLIC_AVG
DIASTOLIC_MAX
DIASTOLIC_MIN
SYSTOLIC_AVG
SYSTOLIC_MAX
SYSTOLIC_MIN
體脂肪

  • 記錄類型： 即時

  • 必填欄位

    percentage
    metadata
    time
身體測量資料 BodyFatRecord

androidx.health.permission.BodyFat.READ
androidx.health.permission.BodyFat.WRITE

體溫

  健康指標指南
  • 記錄類型： 即時
  • 單位： 溫度

  • 必填欄位

    temperature
    measurementLocation
    metadata
    time
生理指標 BodyTemperatureRecord

androidx.health.permission.BodyTemperature.READ
androidx.health.permission.BodyTemperature.WRITE

身體水含量

  • 記錄類型： 即時
  • 單位： 質量

  • 必填欄位

    mass
    metadata
    time
身體測量資料 BodyWaterMassRecord

androidx.health.permission.BodyWaterMass.READ
androidx.health.permission.BodyWaterMass.WRITE

骨質密度

  • 記錄類型： 即時
  • 單位： 質量

  • 必填欄位

    mass
    metadata
    time
身體測量資料 BoneMassRecord

androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.WRITE

子宮頸黏液

  • 記錄類型： 即時

  • 必填欄位

    appearance
    sensation
    metadata
    time
經期追蹤 CervicalMucusRecord

androidx.health.permission.CervicalMucus.READ
androidx.health.permission.CervicalMucus.WRITE

單車踩踏頻率

  訓練指南
  • 記錄類型： 系列賽

  • 必填欄位

    samples
    endTime
    metadata
    samples
    startTime
活動 CyclingPedalingCadenceRecord

androidx.health.permission.Exercise.READ
androidx.health.permission.Exercise.WRITE

匯總資料類型

RPM_AVG
RPM_MAX
RPM_MIN
距離

  訓練指南
  • 記錄類型： 間隔
  • 單位： 長度

  • 必填欄位

    distance
    endTime
    metadata
    startTime
活動 DistanceRecord

androidx.health.permission.Distance.READ
androidx.health.permission.Distance.WRITE

匯總資料類型

DISTANCE_TOTAL
海拔高度變化

  訓練指南
  • 記錄類型： 間隔
  • 單位： 長度

  • 必填欄位

    elevation
    endTime
    metadata
    startTime
活動 ElevationGainedRecord

androidx.health.permission.ElevationGained.READ
androidx.health.permission.ElevationGained.WRITE

匯總資料類型

ELEVATION_GAINED_TOTAL
運動

  「訓練」指南
  新增運動路線指南
  • 記錄類型： 間隔

  • 必填欄位

    exerciseType
    endTime
    laps
    metadata
    segments
    startTime
活動 ExerciseSessionRecord

androidx.health.permission.ExerciseSession.READ
androidx.health.permission.ExerciseSession.WRITE

運動類型

查看所有運動類型
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
活動 FloorsClimbedRecord

androidx.health.permission.FloorsClimbed.READ
androidx.health.permission.FloorsClimbed.WRITE

匯總資料類型

FLOORS_CLIMBED_TOTAL
心率

  生理指標指南
  • 記錄類型： 系列賽

  • 必填欄位

    samples
    endTime
    metadata
    startTime
生理指標 HeartRateRecord

androidx.health.permission.HeartRate.READ
androidx.health.permission.HeartRate.WRITE

匯總資料類型

BPM_AVG
BPM_MAX
BPM_MIN
MEASUREMENTS_COUNT
心率變異

  Android Vitals 指南
  • 記錄類型： 即時

  • 必填欄位

    heartRateVariabilityMillis
    metadata
    time
生理指標 HeartRateVariabilityRmssdRecord

androidx.health.permission.HeartRateVariability.READ
androidx.health.permission.HeartRateVariability.WRITE

高度

  • 記錄類型： 即時
  • 單位： 長度

  • 必填欄位

    height
    metadata
    time
身體測量資料 HeightRecord

androidx.health.permission.Height.READ
androidx.health.permission.Height.WRITE

匯總資料類型

HEIGHT_AVG
HEIGHT_MAX
HEIGHT_MIN
補水

  • 記錄類型： 間隔
  • 單位： 音量

  • 必填欄位

    endTime
    metadata
    startTime
    volume
營養 HydrationRecord

androidx.health.permission.Hydration.READ
androidx.health.permission.Hydration.WRITE

匯總資料類型

VOLUME_TOTAL
經間期出血

  • 記錄類型： 即時

  • 必填欄位

    metadata
    time
經期追蹤 IntermenstrualBleedingRecord

androidx.health.permission.IntermenstrualBleeding.READ
androidx.health.permission.IntermenstrualBleeding.WRITE

淨體重

  • 記錄類型： 即時
  • 單位： 質量

  • 必填欄位

    mass
    metadata
    time
身體測量資料 LeanBodyMassRecord

androidx.health.permission.LeanBodyMass.READ
androidx.health.permission.LeanBodyMass.WRITE

Menstruation


適用於 MenstruationFlowRecord：
  • 記錄類型： 即時

  • 必填欄位

    flow
    metadata
    time

適用於 MenstruationPeriodRecord：
  • 記錄類型： 間隔

  • 必填欄位

    endTime
    metadata
    startTime
經期追蹤 MenstruationFlowRecord

MenstruationPeriodRecord

androidx.health.permission.Menstruation.READ
androidx.health.permission.Menstruation.WRITE


正念

  追蹤正念指南
  • 記錄類型： 間隔

  • 必填欄位

    endTime
    metadata
    mindfulnessSessionType
    startTime
健康 MindfulnessSessionRecord


FEATURE_MINDFULNESS_SESSION

正念練習類型

查看所有正念課程類型
MINDFULNESS_SESSION_TYPE_UNKNOWN
MINDFULNESS_SESSION_TYPE_MEDITATION
MINDFULNESS_SESSION_TYPE_BREATHING
MINDFULNESS_SESSION_TYPE_MUSIC
MINDFULNESS_SESSION_TYPE_MOVEMENT
MINDFULNESS_SESSION_TYPE_UNGUIDED

匯總資料類型

MINDFULNESS_DURATION_TOTAL
營養

  • 記錄類型： 間隔
  • 單位： 質量

  • 必填欄位

    endTime
    mealType
    metadata
    startTime
營養 NutritionRecord

androidx.health.permission.Nutrition.READ
androidx.health.permission.Nutrition.WRITE

匯總資料類型

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

androidx.health.permission.OvulationTest.READ
androidx.health.permission.OvulationTest.WRITE

血氧濃度

  生理指標指南
  • 記錄類型： 即時

  • 必填欄位

    metadata
    percentage
    time
生理指標 OxygenSaturationRecord

androidx.health.permission.OxygenSaturation.READ
androidx.health.permission.OxygenSaturation.WRITE

預定運動

  訓練指南
  訓練計畫指南
  • 記錄類型： 間隔

  • 必填欄位

    block
    endTime
    exerciseType
    hasExplicitTime
    metadata
活動 PlannedExerciseSessionRecord

androidx.health.permission.PlannedExerciseSession.READ
androidx.health.permission.PlannedExerciseSession.WRITE

FEATURE_PLANNED_EXERCISE
力量

  訓練指南
  • 記錄類型： 系列賽

  • 必填欄位

    endTime
    samples
    metadata
    startTime
活動 PowerRecord

androidx.health.permission.Power.READ
androidx.health.permission.Power.WRITE

匯總資料類型

POWER_AVG
POWER_MAX
POWER_MIN
呼吸速率

  生理指標指南
  • 記錄類型： 即時

  • 必填欄位

    metadata
    rate
    time
生理指標 RespiratoryRateRecord

androidx.health.permission.RespiratoryRate.READ
androidx.health.permission.RespiratoryRate.WRITE

靜止心率

  健康指標指南
  • 記錄類型： 即時

  • 必填欄位

    beatsPerMinute
    metadata
    time
生理指標 RestingHeartRateRecord

androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeartRate.WRITE

匯總資料類型

BPM_AVG
BPM_MAX
BPM_MIN
性活動

  • 記錄類型： 即時

  • 必填欄位

    metadata
    protectionUsed
    time
經期追蹤 SexualActivityRecord

androidx.health.permission.SexualActivity.READ
androidx.health.permission.SexualActivity.WRITE

皮膚溫度

  生理指標指南
  測量皮膚溫度指南
  • 記錄類型： 系列賽
  • 單位： 溫度

  • 必填欄位

    deltas
    endTime
    measurementLocation
    metadata
    startTime
生理指標 SkinTemperatureRecord


FEATURE_SKIN_TEMPERATURE

匯總資料類型

TEMPERATURE_DELTA_AVG
TEMPERATURE_DELTA_MAX
TEMPERATURE_DELTA_MIN
睡眠時段

  睡眠指南
  追蹤睡眠時段指南
  • 記錄類型： 間隔

  • 必填欄位

    endTime
    metadata
    stages
    startTime
睡眠 SleepSessionRecord

androidx.health.permission.SleepSession.READ
androidx.health.permission.SleepSession.WRITE

匯總資料類型

SLEEP_DURATION_TOTAL
速度

  訓練指南
  • 記錄類型： 系列賽

  • 必填欄位

    endTime
    metadata
    samples
    startTime
活動 SpeedRecord

androidx.health.permission.Speed.READ
androidx.health.permission.Speed.WRITE

匯總資料類型

SPEED_AVG
SPEED_MAX
SPEED_MIN
步驟

  「訓練」指南

如要記錄步數：
  • 記錄類型： 間隔

  • 必填欄位

    count
    endTime
    metadata
    startTime

步驟節奏記錄：
  • 記錄類型： 系列賽

  • 必填欄位

    endTime
    samples
    metadata
    startTime
活動 StepsRecord

StepsCadenceRecord

androidx.health.permission.Steps.READ
androidx.health.permission.Steps.WRITE

StepsRecord 的匯總資料類型

COUNT_TOTAL

StepsCadenceRecord 的匯總資料類型

RATE_AVG
RATE_MAX
RATE_MIN
卡路里燃燒量總計

  訓練指南
  • 記錄類型： 間隔
  • 單元： 能源

  • 必填欄位

    endTime
    energy
    metadata
    startTime
活動 TotalCaloriesBurnedRecord

androidx.health.permission.TotalCaloriesBurned.READ
androidx.health.permission.TotalCaloriesBurned.WRITE

匯總資料類型

ENERGY_TOTAL
最大攝氧量

  訓練指南
  • 記錄類型： 即時

  • 必填欄位

    measurementMethod
    metadata
    time
    vo2MillilitersPerMinuteKilogram
活動 Vo2MaxRecord

androidx.health.permission.VO2Max.READ
androidx.health.permission.VO2Max.WRITE

權重

  • 記錄類型： 即時

  • 必填欄位

    metadata
    time
    weight
身體測量資料 WeightRecord

androidx.health.permission.Weight.READ
androidx.health.permission.Weight.WRITE

匯總資料類型

WEIGHT_AVG
WEIGHT_MAX
WEIGHT_MIN
推動輪椅次數

  「健身」指南
  • 記錄類型： 間隔

  • 必填欄位

    count
    endTime
    metadata
    startTime
活動 WheelchairPushesRecord

androidx.health.permission.WheelchairPushes.READ
androidx.health.permission.WheelchairPushes.WRITE

匯總資料類型

COUNT_TOTAL