「健康資料同步」會儲存及建構健康與健身資料和醫療記錄資料。請務必先瞭解 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. 篩選資料類型表格
下表完整列出資料類型,並提供各類型的類別、功能旗標和指南,以及權限聲明。
資料類型 功能指南 |
類別 | 記錄類型 權限聲明 功能旗標 |
---|---|---|
活動卡路里燃燒量 |
活動 |
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 |