「健康資料同步」會儲存及建構健康與健身資料和醫療記錄資料。請務必先瞭解 Health Connect 提供的資料類型和權限,再規劃應用程式的需求。
開發完成後,準備將應用程式發布至 Play 商店時,您必須聲明應用程式的資料使用方式,以及聲明應用程式使用的 Health Connect 資料類型存取權。否則,系統可能會向使用者顯示錯誤訊息,指出應用程式無法存取需要特別核准的「健康資料同步」資料類型。
詳情請參閱「在 Play 管理中心完成健康應用程式聲明」。
資料類型類別
Health Connect 支援多數健康與健身應用程式使用的資料類型,盡可能提供多樣化的資料。健康資料同步致力於提供全方位健康與健身資料的總覽與儲存。這些資料類型可分為以下幾類:
| 類別 | 說明 | |
|---|---|---|
| directions_run | 活動 | 擷取使用者進行的任何活動,可以包括各種健康與健身活動,例如跑步和游泳。 |
| 拉直 | 身體測量 | 擷取與身體相關的常見資料,例如使用者的體重和基礎代謝率。 |
| fertile | 週期追蹤 | 擷取月經週期及相關資料點,例如排卵測試的二元結果。 |
| 雜貨 | 營養 | 擷取水份和營養資料類型,前者代表使用者一次飲用的水量,後者則有卡路里、糖和鎂等選用欄位。 |
| sleep_auto | 睡眠 | 這會擷取與使用者睡眠時間間隔長度及睡眠類型相關的資料。 |
| vital_signs | Vitals | 這會擷取關於使用者一般健康的重要資訊。包括體溫、血糖、血壓和血氧濃度等資料。 |
| 正念 | 健康 | 這會擷取與使用者心理健康和福祉相關的資料。 |
健康與健身資料類型
要求任何權限之前,應用程式必須先在資訊清單中宣告權限。詳情請參閱快速入門指南的「宣告權限」一節。
如要在應用程式處於背景時讀取資料,或讀取歷史資料,必須另外宣告一組讀取權限,與資料類型權限分開:
| 額外讀取權限 | 權限宣告 |
|---|---|
|
在背景讀取資料
背景讀取範例指南 |
android.permission.health.READ_HEALTH_DATA_IN_BACKGROUND |
|
讀取歷來資料
讀取 30 天前的資料指南 |
android.permission.health.READ_HEALTH_DATA_HISTORY |
1. 選取 Jetpack 版本
Jetpack 版本之間的權限聲明有所不同,請務必選取應用程式使用的 Jetpack 版本範圍。
2. 篩選資料類型表格
下表完整列出資料類型,並提供各類型的類別、功能旗標和指南,以及權限聲明。
| 資料類型 功能指南 |
類別 | 記錄類型 權限聲明 功能旗標 |
|---|---|---|
| 活動卡路里燃燒量 |
活動 |
ActiveCaloriesBurnedRecordandroid.permission.health.READ_ACTIVE_CALORIES_BURNED android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| 活動強度 |
活動 |
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 |
| 單車踩踏頻率 |
活動 |
CyclingPedalingCadenceRecordandroid.permission.health.READ_EXERCISE android.permission.health.WRITE_EXERCISE |
| 距離 |
活動 |
DistanceRecordandroid.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE |
| 爬升高度 |
活動 |
ElevationGainedRecordandroid.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED |
| 運動 新增運動路線指南 |
活動 |
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 |
| 爬樓梯數 |
活動 |
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 |
| 補水 |
營養 |
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 |
| Menstruation |
經期追蹤 |
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 |
| 預定運動 訓練計畫指南 |
活動 |
PlannedExerciseSessionRecordandroid.permission.health.READ_PLANNED_EXERCISE android.permission.health.WRITE_PLANNED_EXERCISE FEATURE_PLANNED_EXERCISE |
| Power |
活動 |
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 |
| 性活動 |
活動 |
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 |
| 速度 |
活動 |
SpeedRecordandroid.permission.health.READ_SPEED android.permission.health.WRITE_SPEED |
| 步數 |
活動 |
StepsRecordStepsCadenceRecordandroid.permission.health.READ_STEPS android.permission.health.WRITE_STEPS |
| 卡路里燃燒總量 |
活動 |
TotalCaloriesBurnedRecordandroid.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED |
| 最大攝氧量 |
活動 |
Vo2MaxRecordandroid.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
| 權重 |
身體測量資料 |
WeightRecordandroid.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT |
| 推輪椅次數 |
活動 |
WheelchairPushesRecordandroid.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES |