Health Connect จัดเก็บและจัดโครงสร้างทั้งข้อมูลสุขภาพและการออกกำลังกาย รวมถึงข้อมูลบันทึกทางการแพทย์ คุณควรทำความเข้าใจก่อนว่า Health Connect มีประเภทข้อมูลและสิทธิ์ใดบ้าง เพื่อวางแผนข้อกำหนดของแอป
หลังจากพัฒนาแอปและเตรียมเผยแพร่แอปไปยัง Play Store แล้ว คุณ ต้องประกาศการใช้ข้อมูลของแอป รวมถึงประกาศการเข้าถึงประเภทข้อมูล Health Connect ที่แอปใช้ มิเช่นนั้น ผู้ใช้อาจได้รับข้อความแสดงข้อผิดพลาดที่แอปของคุณไม่สามารถเข้าถึงประเภทข้อมูล Health Connect เนื่องจากต้องได้รับการอนุมัติเป็นพิเศษ
ดูข้อมูลเพิ่มเติมได้ที่ทำการประกาศแอปสุขภาพใน Play Console ให้เสร็จสมบูรณ์
หมวดหมู่ประเภทข้อมูล
Health Connect รองรับประเภทข้อมูลที่ใช้ในแอปสุขภาพและการออกกำลังกายส่วนใหญ่เพื่อมอบความหลากหลายให้มากที่สุด Health Connect มีเป้าหมายที่จะนำเสนอ มุมมองและการจัดเก็บข้อมูลสุขภาพและการออกกำลังกายที่ครอบคลุม ประเภทข้อมูลเหล่านี้แบ่งออกเป็นหมวดหมู่ได้ดังนี้
| หมวดหมู่ | คำอธิบาย | |
|---|---|---|
| directions_run | กิจกรรม | ซึ่งจะบันทึกกิจกรรมทั้งหมดที่ผู้ใช้ทำ ซึ่งอาจรวมถึงกิจกรรมด้านสุขภาพและการออกกำลังกาย เช่น วิ่งและว่ายน้ำ |
| straighten | การตรวจวัดร่างกาย | ซึ่งจะบันทึกข้อมูลทั่วไปที่เกี่ยวข้องกับร่างกาย เช่น น้ำหนักของผู้ใช้และอัตราการเผาผลาญขณะพัก (Basal metabolic rate (BMR)) |
| fertile | การติดตามรอบเดือน | ซึ่งจะบันทึกรอบเดือนและจุดข้อมูลที่เกี่ยวข้อง เช่น ผลลัพธ์แบบไบนารีของการทดสอบการตกไข่ |
| grocery | โภชนาการ | ซึ่งจะบันทึกประเภทข้อมูลการดื่มน้ำและโภชนาการ โดยค่าแรกแสดงปริมาณน้ำที่ผู้ใช้ดื่มในแต่ละครั้ง อย่างหลังรวมถึงฟิลด์ที่ไม่บังคับ เช่น แคลอรี่ น้ำตาล และแมกนีเซียม |
| sleep_auto | การนอนหลับ | ซึ่งจะบันทึกข้อมูลช่วงเวลาที่เกี่ยวข้องกับระยะเวลาและประเภทการนอนหลับของผู้ใช้ |
| vital_signs | ค่าสัญญาณชีพ | ซึ่งจะบันทึกข้อมูลสำคัญเกี่ยวกับสุขภาพทั่วไปของผู้ใช้ รวมถึงข้อมูลต่างๆ เช่น อุณหภูมิร่างกาย น้ำตาลกลูโคสในเลือด ความดันโลหิต และความอิ่มตัวของออกซิเจนในเลือด |
| mindfulness | สุขภาวะ | ซึ่งจะบันทึกข้อมูลที่เกี่ยวข้องกับสุขภาพจิตและความเป็นอยู่ของผู้ใช้ |
คู่มือประสบการณ์สำหรับนักพัฒนาแอป
Health Connect มีคำแนะนำด้านประสบการณ์การใช้งานสำหรับนักพัฒนาแอปที่มุ่งเน้นกรณีการใช้งานด้านสุขภาพและการออกกำลังกายที่เฉพาะเจาะจง คำแนะนำเหล่านี้แสดงวิธีใช้ข้อมูลประเภทที่เกี่ยวข้องร่วมกันเพื่อสร้างฟีเจอร์สำหรับ
ตารางประเภทข้อมูลต่อไปนี้ยังระบุคำแนะนำเกี่ยวกับประสบการณ์ที่ เชื่อมโยงกับประเภทข้อมูลแต่ละประเภทด้วย
ฟิลด์ประเภทข้อมูล
ตารางประเภทข้อมูล Health Connect มีคอลัมน์ฟิลด์หลายคอลัมน์ที่จะช่วยให้คุณ เข้าใจโครงสร้างและข้อกำหนดของข้อมูลแต่ละประเภท คอลัมน์เหล่านี้มีดังนี้
| ช่อง | คำอธิบาย | |
|---|---|---|
| กำหนดเวลา | ประเภทระเบียน | ระบุว่ามีการบันทึกข้อมูล ณ เวลาใดเวลาหนึ่งหรือในช่วงเวลาหนึ่ง ค่าที่เป็นไปได้มีดังนี้ Interval, Instantaneous, Series |
| straighten | หน่วย | หน่วยวัดสำหรับประเภทข้อมูล (เช่น แคลอรี่ เมตร จำนวน) |
| ดาว | ฟิลด์ที่ต้องระบุ | ฟิลด์เหล่านี้เป็นฟิลด์ที่จำเป็นซึ่งต้องรวมไว้เมื่อเขียนข้อมูลสำหรับประเภทข้อมูลนี้ เพื่อช่วยรักษาความสมบูรณ์และประโยชน์ของข้อมูล |
ประเภทข้อมูลสุขภาพและการออกกำลังกาย
ก่อนที่จะขอสิทธิ์ใดๆ แอปของคุณต้องประกาศสิทธิ์เหล่านั้นในไฟล์ Manifest ดูข้อมูลเพิ่มเติมได้ที่ส่วนประกาศสิทธิ์ของคู่มือเริ่มใช้งานฉบับย่อ
หากต้องการอ่านข้อมูลขณะที่แอปทำงานในเบื้องหลังหรืออ่านข้อมูลย้อนหลัง คุณต้องประกาศชุดสิทธิ์อ่านเพิ่มเติมแยกจากสิทธิ์ประเภทข้อมูล ดังนี้
| สิทธิ์อ่านเพิ่มเติม | การประกาศสิทธิ์ |
|---|---|
|
อ่านข้อมูลในเบื้องหลัง
คู่มือตัวอย่างการอ่านในเบื้องหลัง |
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 ประเภทข้อมูลรวมACTIVE_CALORIES_TOTAL |
| ความเข้มข้นของกิจกรรม คู่มือการออกกำลังกาย
|
กิจกรรม | ActivityIntensityRecord
android.permission.health.READ_ACTIVITY_INTENSITY android.permission.health.WRITE_ACTIVITY_INTENSITY FEATURE_ACTIVITY_INTENSITYประเภทข้อมูลรวมDURATION_TOTALINTENSITY_MINUTES_TOTALMODERATE_DURATION_TOTALVIGOROUS_DURATION_TOTAL |
อุณหภูมิของร่างกายขณะพัก
|
การติดตามรอบเดือน | 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 ประเภทข้อมูลรวมBASAL_CALORIES_TOTAL |
| ระดับน้ำตาลในเลือด คู่มือค่าสัญญาณชีพ
|
ค่าสัญญาณชีพ | 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 ประเภทข้อมูลรวมDIASTOLIC_AVGDIASTOLIC_MAXDIASTOLIC_MINSYSTOLIC_AVGSYSTOLIC_MAXSYSTOLIC_MIN |
ไขมันร่างกาย
|
การตรวจวัดร่างกาย | 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 ประเภทข้อมูลรวมRPM_AVGRPM_MAXRPM_MIN |
| ระยะทาง คู่มือการออกกำลังกาย
|
กิจกรรม | DistanceRecord
android.permission.health.READ_DISTANCE android.permission.health.WRITE_DISTANCE ประเภทข้อมูลรวมDISTANCE_TOTAL |
| ระดับความสูงที่เพิ่มขึ้น คู่มือการออกกำลังกาย
|
กิจกรรม | ElevationGainedRecord
android.permission.health.READ_ELEVATION_GAINED android.permission.health.WRITE_ELEVATION_GAINED ประเภทข้อมูลรวมELEVATION_GAINED_TOTAL |
| การออกกำลังกาย คู่มือการออกกำลังกาย คู่มือเพิ่มเส้นทางการออกกำลังกาย
|
กิจกรรม | 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_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_SOFTBALL EXERCISE_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
ประเภทข้อมูลรวมEXERCISE_DURATION_TOTAL |
| จำนวนชั้นที่ขึ้น คู่มือการออกกำลังกาย
|
กิจกรรม | FloorsClimbedRecord
android.permission.health.READ_FLOORS_CLIMBED android.permission.health.WRITE_FLOORS_CLIMBED ประเภทข้อมูลรวมFLOORS_CLIMBED_TOTAL |
| อัตราการเต้นของหัวใจ คู่มือค่าสัญญาณชีพ
|
ค่าสัญญาณชีพ | HeartRateRecord
android.permission.health.READ_HEART_RATE android.permission.health.WRITE_HEART_RATE ประเภทข้อมูลรวมBPM_AVGBPM_MAXBPM_MINMEASUREMENTS_COUNT |
| ความแปรปรวนของอัตราการเต้นของหัวใจ คู่มือค่าสัญญาณชีพ
|
ค่าสัญญาณชีพ | 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 ประเภทข้อมูลรวมHEIGHT_AVGHEIGHT_MAXHEIGHT_MIN |
การดื่มน้ำ
|
โภชนาการ | HydrationRecord
android.permission.health.READ_HYDRATION android.permission.health.WRITE_HYDRATION ประเภทข้อมูลรวมVOLUME_TOTAL |
ภาวะเลือดออกระหว่างรอบประจำเดือน
|
การติดตามรอบเดือน | 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 |
| ประจำเดือน สำหรับ MenstruationFlowRecord:
สำหรับ MenstruationPeriodRecord:
|
การติดตามรอบเดือน | 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ประเภทเซสชันการเจริญสติดูประเภทเซสชัน การเจริญสติทั้งหมดMINDFULNESS_SESSION_TYPE_UNKNOWNMINDFULNESS_SESSION_TYPE_MEDITATIONMINDFULNESS_SESSION_TYPE_BREATHINGMINDFULNESS_SESSION_TYPE_MUSICMINDFULNESS_SESSION_TYPE_MOVEMENTMINDFULNESS_SESSION_TYPE_UNGUIDEDประเภทข้อมูลรวมMINDFULNESS_DURATION_TOTAL |
โภชนาการ
|
โภชนาการ | NutritionRecord
android.permission.health.READ_NUTRITION android.permission.health.WRITE_NUTRITION ประเภทข้อมูลรวมBIOTIN_TOTALCAFFEINE_TOTALCALCIUM_TOTALCHLORIDE_TOTALCHOLESTEROL_TOTALCHROMIUM_TOTALCOPPER_TOTALDIETARY_FIBER_TOTALENERGY_FROM_FAT_TOTALENERGY_TOTALFOLATE_TOTALFOLIC_ACID_TOTALIODINE_TOTALIRON_TOTALMAGNESIUM_TOTALMANGANESE_TOTALMOLYBDENUM_TOTALMONOUNSATURATED_FAT_TOTALNIACIN_TOTALPANTOTHENIC_ACID_TOTALPHOSPHORUS_TOTALPOLYUNSATURATED_FAT_TOTALPOTASSIUM_TOTALPROTEIN_TOTALRIBOFLAVIN_TOTALSATURATED_FAT_TOTALSELENIUM_TOTALSODIUM_TOTALSUGAR_TOTALTHIAMIN_TOTALTOTAL_CARBOHYDRATE_TOTALTOTAL_FAT_TOTALTRANS_FAT_TOTALUNSATURATED_FAT_TOTALVITAMIN_A_TOTALVITAMIN_B12_TOTALVITAMIN_B6_TOTALVITAMIN_C_TOTALVITAMIN_D_TOTALVITAMIN_E_TOTALVITAMIN_K_TOTALZINC_TOTAL |
การทดสอบการตกไข่
|
การติดตามรอบเดือน | 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 |
| กำลัง คำแนะนำการออกกำลังกาย
|
กิจกรรม | PowerRecord
android.permission.health.READ_POWER android.permission.health.WRITE_POWER ประเภทข้อมูลรวมPOWER_AVGPOWER_MAXPOWER_MIN |
| อัตราการหายใจ คู่มือค่าสัญญาณชีพ
|
ค่าสัญญาณชีพ | 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 ประเภทข้อมูลรวมBPM_AVGBPM_MAXBPM_MIN |
กิจกรรมทางเพศ
|
การติดตามรอบเดือน | 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ประเภทข้อมูลรวมTEMPERATURE_DELTA_AVGTEMPERATURE_DELTA_MAXTEMPERATURE_DELTA_MIN |
| เซสชันการนอนหลับ คู่มือการนอนหลับ คู่มือติดตามเซสชันการนอนหลับ
|
การนอนหลับ | SleepSessionRecord
android.permission.health.READ_SLEEP android.permission.health.WRITE_SLEEP ประเภทข้อมูลรวมSLEEP_DURATION_TOTAL |
| ความเร็ว คำแนะนำเกี่ยวกับ
|
กิจกรรม | SpeedRecord
android.permission.health.READ_SPEED android.permission.health.WRITE_SPEED ประเภทข้อมูลรวมSPEED_AVGSPEED_MAXSPEED_MIN |
| ขั้นตอน คู่มือการออกกำลังกาย สำหรับ StepsRecord:
สำหรับ StepsCadenceRecord:
|
กิจกรรม | StepsRecord
StepsCadenceRecord
android.permission.health.READ_STEPS android.permission.health.WRITE_STEPS ประเภทข้อมูลรวมสำหรับ StepsRecordCOUNT_TOTALประเภทข้อมูลรวมสำหรับ StepsCadenceRecordRATE_AVGRATE_MAXRATE_MIN |
| แคลอรี่ที่ใช้ไปทั้งหมด คู่มือการออกกำลังกาย
|
กิจกรรม | TotalCaloriesBurnedRecord
android.permission.health.READ_TOTAL_CALORIES_BURNED android.permission.health.WRITE_TOTAL_CALORIES_BURNED ประเภทข้อมูลรวมENERGY_TOTAL |
| VO2 max คำแนะนำเกี่ยวกับ
|
กิจกรรม | Vo2MaxRecord
android.permission.health.READ_VO2_MAX android.permission.health.WRITE_VO2_MAX |
น้ำหนัก
|
การตรวจวัดร่างกาย | WeightRecord
android.permission.health.READ_WEIGHT android.permission.health.WRITE_WEIGHT ประเภทข้อมูลรวมWEIGHT_AVGWEIGHT_MAXWEIGHT_MIN |
| การทำวีลแชร์พุช คู่มือการออกกำลังกาย
|
กิจกรรม | WheelchairPushesRecord
android.permission.health.READ_WHEELCHAIR_PUSHES android.permission.health.WRITE_WHEELCHAIR_PUSHES ประเภทข้อมูลรวมCOUNT_TOTAL |