Health Connect จะจัดเก็บและจัดโครงสร้างข้อมูลสุขภาพและการออกกำลังกาย และบัญชีนี้ สำหรับวิธีวัดข้อมูลประเภทต่างๆ ข้อมูลประเภทเหล่านี้รวมถึงอัตราการเต้นของหัวใจ มีการวัดค่าทันที จำนวนก้าวตลอดช่วงเวลา และข้อมูลการนอนหลับที่ได้มา ในเซสชัน
คุณต้องเข้าใจก่อนว่าประเภทข้อมูลและสิทธิ์ใด เชื่อมต่อข้อเสนอเพื่อให้คุณวางแผนข้อกำหนดของแอปได้ คุณ คุณต้องตรวจสอบประเภทข้อมูลก่อนจึงจะสรุปข้อกำหนดได้
หมวดหมู่ประเภทข้อมูล
Health Connect รองรับประเภทข้อมูลที่ใช้กับสุขภาพและการออกกำลังกายส่วนใหญ่ แอปให้หลากหลายที่สุดเท่าที่จะทำได้ Health Connect มีเป้าหมายที่จะนำเสนอ มุมมองและการจัดเก็บข้อมูลสุขภาพและการออกกำลังกายที่ครอบคลุม ประเภทข้อมูลเหล่านี้จัด ในหมวดหมู่ต่อไปนี้
- กิจกรรม: จะบันทึกกิจกรรมที่ผู้ใช้ทำ ซึ่งอาจมี กิจกรรมด้านสุขภาพและการออกกำลังกาย เช่น การวิ่ง การว่ายน้ำ และการนอนหลับ
- การวัดขนาดร่างกาย: รวบรวมข้อมูลทั่วไปที่เกี่ยวข้องกับร่างกาย เช่น น้ำหนักของผู้ใช้และอัตราการเผาผลาญขณะพัก
- การติดตามรอบเดือน: ข้อมูลนี้จะรวบรวมรอบเดือนและจุดข้อมูลที่เกี่ยวข้อง เช่น ผลลัพธ์ไบนารีของการทดสอบการตกไข่
- โภชนาการ: ข้อมูลนี้จะบันทึกข้อมูลประเภทปริมาณน้ำที่ดื่มและโภชนาการ โปรไฟล์เก่า แสดงปริมาณน้ำที่ผู้ใช้ดื่มต่อเครื่องดื่ม 1 แก้ว รายการหลัง ประกอบด้วยช่องที่ไม่บังคับ เช่น แคลอรี่ น้ำตาล และแมกนีเซียม
- การนอนหลับ: ตัวเลือกนี้จะบันทึกข้อมูลช่วงที่เกี่ยวข้องกับความยาวและประเภทของผู้ใช้ เต็มอิ่ม
- ข้อมูลสำคัญ: รวบรวมข้อมูลสำคัญเกี่ยวกับทั่วไปของผู้ใช้ สุขภาพ ข้อมูลดังกล่าวรวมถึงข้อมูล เช่น อุณหภูมิของร่างกาย น้ำตาลกลูโคสในเลือด เลือด ความดัน และความอิ่มตัวของออกซิเจนในเลือด
รูปแบบประเภทข้อมูล
ประเภทข้อมูลใน Health Connect จัดเก็บไว้ในออบเจ็กต์ที่เป็นคลาสย่อยของ
Record
สำหรับข้อมูลแต่ละประเภท จะมีช่องที่เกี่ยวข้องซึ่งมีข้อมูลทั่วไป เช่น
time และ zoneOffset หรือเฉพาะเจาะจง เช่น title, count และ percentage
บางช่องใช้ประเภทแบบง่าย เช่น แบบยาว แบบคู่ หรือแบบสตริง ในขณะที่ช่องอื่นๆ ใช้
ประเภทที่ซับซ้อน เช่น การแจงนับและคลาส เช่น Instant และ
ZoneOffset คุณอาจต้องระบุแอตทริบิวต์ของช่องเหล่านี้ หรือ
ไม่บังคับ แอตทริบิวต์บางรายการเป็นแบบอ่านอย่างเดียว และแอตทริบิวต์บางรายการถูกจำกัดไว้ที่
ช่วงของค่าที่กำหนด
หากต้องการดูรายการประเภทข้อมูลที่มีอยู่ทั้งหมดและช่องของประเภทข้อมูลเหล่านั้น โปรดดูคลาส ใน Jetpack
แอตทริบิวต์ข้อมูลเพิ่มเติม
ข้อมูลใน Health Connect API ยังรวมแอตทริบิวต์ข้อมูลเมตาด้วย ตามที่อธิบายไว้ในรายการต่อไปนี้
- รหัส Health Connect: ระบบจะกำหนดจุดข้อมูลแต่ละจุดด้วยตัวระบุที่ไม่ซ้ำกัน (UID) ขณะสร้าง ซึ่งมีประโยชน์สำหรับการดำเนินการอ่านและเขียนมาตรฐาน ดูรายละเอียดเพิ่มเติมได้ที่รหัส Health Connect
- เวลาที่แก้ไขล่าสุด: ทำเครื่องหมายการประทับเวลาที่อินสแตนซ์สุดท้ายเป็นระเบียน มีอัปเดต ซึ่งสร้างขึ้นโดยอัตโนมัติเมื่อมีการสร้าง บันทึกหรือทุกครั้งที่อัปเดต
- ต้นทางข้อมูล: Health Connect จัดเก็บข้อมูลเกี่ยวกับแอปที่มี ของคุณ ซึ่งมีชื่อแพ็กเกจของต้นทางนั้น ซึ่งก็คือ เพิ่มโดยอัตโนมัติขณะสร้าง
- อุปกรณ์: Health Connect จัดเก็บข้อมูลเกี่ยวกับอุปกรณ์ที่มีข้อมูล มาจากไหน มีข้อมูลผู้ผลิตและรุ่นของอุปกรณ์นั้นๆ ซึ่งคุณ ระบุค่าด้วยตนเอง
- Client-ID: Health Connect มีรหัสไคลเอ็นต์เพื่อให้แอปไคลเอ็นต์ดำเนินการต่างๆ ได้ อ้างอิงข้อมูลโดยใช้รหัสของตัวเอง ซึ่งช่วยแก้ไขข้อขัดแย้งและ ทำให้การซิงค์ง่ายขึ้น ข้อมูลนี้ใช้สำหรับระเบียนด้วยตนเอง
- เวอร์ชันระเบียนไคลเอ็นต์: Health Connect มาพร้อมกับ Client-ID การกำหนดเวอร์ชัน เพื่อช่วยติดตามการเปลี่ยนแปลงระหว่างการซิงค์ข้อมูล มอบให้แก่ บันทึกด้วยตัวเอง
- วิธีการบันทึก: Health Connect ช่วยให้คุณเข้าใจวิธีการบันทึกข้อมูล วิธีการเหล่านี้รวมถึงแอปที่บันทึกข้อมูลแบบแฝง (โดยอัตโนมัติ) และผู้ใช้ ในการบันทึกข้อมูลอย่างต่อเนื่อง หรือด้วยตนเอง
รหัส Health Connect
Health Connect จะกำหนดตัวระบุที่ไม่ซ้ำกัน (UID) ให้กับออบเจ็กต์ข้อมูลที่เพิ่งแทรก ซึ่งจะระบุออบเจ็กต์ข้อมูลและแยกออบเจ็กต์จากออบเจ็กต์อื่นๆ รหัส Health Connect มีประโยชน์ในคำขออ่านหรือเขียน รหัส Health Connect ไม่เหมือนกับรหัส Client-ID แอปไคลเอ็นต์จะกำหนด Client-ID ขณะที่ Health Connect เพียงอย่างเดียว กำหนดรหัส Health Connect
โปรดทราบในหมายเหตุต่อไปนี้เมื่อจะใช้รหัส Health Connect
- เซสชันจะมีรหัส Health Connect เดียว แต่ข้อมูลภายในเซสชันมีรหัส รหัส Health Connect ของตัวเอง
- รหัส Health Connect ไม่เชื่อมโยงหรือเกี่ยวข้องกับการประทับเวลา
- กรณีการใช้งานบางกรณีอาจต้องจัดเก็บรหัส Health Connect ที่เฉพาะเจาะจงระหว่าง เวิร์กโฟลว์ ตัวอย่างเช่น ต้องมีรหัสเฉพาะเพื่อดึงข้อมูลและแสดงต่อ ใช้ข้อมูลที่เพิ่งบันทึกให้กับผู้ใช้
เวลาใน Health Connect
ข้อมูลทั้งหมดที่เขียนลงใน Health Connect ต้องระบุข้อมูลออฟเซ็ตโซน การระบุออฟเซ็ตโซนจะช่วยให้แอปอ่านข้อมูลเพื่อแสดงข้อมูลออกมาได้ คดีทั่วไป เวลาที่เหมาะสมคือเวลาท้องถิ่นซึ่งเกี่ยวข้องกับผู้ใช้ แต่ไม่จำเป็นต้องเป็นเวลา Coordinated Universal Time (UTC)
ในบางกรณีที่เกิดขึ้นไม่บ่อยนัก ออฟเซ็ตโซนอาจใช้งานไม่ได้ เมื่อเกิดกรณีนี้ขึ้น ใน Android 14 (API ระดับ 34) Health Connect จะกำหนดออฟเซ็ตโซนตาม เขตเวลาเริ่มต้นของระบบของอุปกรณ์ ใน Android 13 และเวอร์ชันต่ำกว่า (API ระดับ 33 และต่ำกว่า) สามารถเขียนไปยัง Health Connect ได้โดยไม่ต้อง ระบุข้อมูลออฟเซ็ตของโซน ซึ่งต้องหลีกเลี่ยงเมื่อเป็นไปได้
การตั้งค่าเวลาและโซน
การระบุข้อมูลออฟเซ็ตของโซนขณะเขียนข้อมูลจะระบุเขตเวลา เมื่ออ่านข้อมูลใน Health Connect แต่อาจไม่สำเร็จ ในบางสถานการณ์ เช่น เมื่อไม่มีการระบุค่าชดเชยโซน แอปของคุณ คุณต้องเตรียมรับมือกับข้อมูลทั้ง 2 ประเภท ในลักษณะที่เหมาะสม สำหรับสถานการณ์เฉพาะของคุณ
สิทธิ์
แอปต้องประกาศสิทธิ์ในไฟล์ Manifest ก่อนขอสิทธิ์ ก่อน ดูตารางต่อไปนี้สำหรับการแมปประเภทข้อมูลทั้งหมดและ สิทธิ์
สำหรับ 1.0.0-alpha10 ขึ้นไป
| ประเภทคลาสการบันทึก | การประกาศสิทธิ์เพื่ออ่านและเขียน |
|---|---|
| แคลอรี่ที่ใช้ไปในร่างกาย |
android.permission.health.READ_ACTIVE_CALORIES_BURNED
android.permission.health.WRITE_ACTIVE_CALORIES_BURNED |
| BasalBodyTemperature |
android.permission.health.READ_BASAL_BODY_TEMPERATURE
android.permission.health.WRITE_BASAL_BODY_TEMPERATURE |
| อัตราการเผาผลาญขณะพัก |
android.permission.health.READ_BASAL_METABOLIC_RATE
android.permission.health.WRITE_BASAL_METABOLIC_RATE |
| น้ำตาลกลูโคสในเลือด |
android.permission.health.READ_BLOOD_GLUCOSE
android.permission.health.WRITE_BLOOD_GLUCOSE |
| ความดันเลือด |
android.permission.health.READ_BLOOD_PRESSURE
android.permission.health.WRITE_BLOOD_PRESSURE |
| ไขมันร่างกาย |
android.permission.health.READ_BODY_FAT
android.permission.health.WRITE_BODY_FAT |
| อุณหภูมิร่างกาย |
android.permission.health.READ_BODY_TEMPERATURE
android.permission.health.WRITE_BODY_TEMPERATURE |
| บอดี้วอเตอร์มัส |
android.permission.health.READ_BODY_WATER_MASS
android.permission.health.WRITE_BODY_WATER_MASS |
| มวลกระดูก |
android.permission.health.READ_BONE_MASS
android.permission.health.WRITE_BONE_MASS |
| CervicalMucus |
android.permission.health.READ_CERVICAL_MUCUS
android.permission.health.WRITE_CERVICAL_MUCUS |
| แผนการปั่นจักรยาน |
android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE |
| ระยะทาง |
android.permission.health.READ_DISTANCE
android.permission.health.WRITE_DISTANCE |
| ระดับความสูงที่เพิ่มขึ้น |
android.permission.health.READ_ELEVATION_GAINED
android.permission.health.WRite_ELEVATION_GAINED |
| เซสชันการออกกำลังกาย |
android.permission.health.READ_EXERCISE
android.permission.health.WRITE_EXERCISE |
| ปีนชั้น |
android.permission.health.READ_FLOORS_CLIMBED
android.permission.health.WRITE_FLOORS_CLIMBED |
| อัตราการเต้นของหัวใจ |
android.permission.health.READ_HEART_RATE
android.permission.health.WRite_HEART_RATE |
| HeartRateVariabilityRmssd |
android.permission.health.READ_HEART_RATE_VARIABILITY
android.permission.health.WRITE_HEART_RATE_VARIABILITY |
| ส่วนสูง |
android.permission.health.READ_HEIGHT
android.permission.health.WRITE_HEIGHT |
| ปริมาณน้ำที่ดื่ม |
android.permission.health.READ_HYDRATION
android.permission.health.WRITE_HYDRATION |
| IntermenstrualBleeding |
android.permission.health.READ_INTERMENSTRUAL_BLEEDING
android.permission.health.WRite_INTERMENSTRUAL_BLEEDING |
| LeanBodyMass |
android.permission.health.READ_LEAN_BODY_MASS
android.permission.health.WRITE_LEAN_BODY_MASS |
| MenstruationFlow |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
| รอบเดือน |
android.permission.health.READ_MENSTRUATION
android.permission.health.WRITE_MENSTRUATION |
| โภชนาการ |
android.permission.health.READ_NUTRITION
android.permission.health.WRITE_NUTRITION |
| การทดสอบไข่ |
android.permission.health.READ_OVULATION_TEST
android.permission.health.WRITE_OVULATION_TEST |
| ความอิ่มตัวของออกซิเจน |
android.permission.health.READ_OXYGEN_SATURATION
android.permission.health.WRite_OXYGEN_SATURATION |
| อำนาจ |
android.permission.health.READ_POWER
android.permission.health.WRITE_POWER |
| อัตราการหายใจ |
android.permission.health.READ_RESPIRATORY_RATE
android.permission.health.WRITE_RESPIRATORY_RATE |
| อัตราการเต้นของหัวใจพัก |
android.permission.health.READ_RESTING_HEART_RATE
android.permission.health.WRite_RESTING_HEART_RATE |
| กิจกรรมทางเพศ |
android.permission.health.READ_SEXUAL_ACTIVITY
android.permission.health.WRITE_SEXUAL_ACTIVITY |
| SleepSession |
android.permission.health.READ_SLEEP
android.permission.health.WRITE_SLEEP |
| ความเร็ว |
android.permission.health.READ_SPEED
android.permission.health.WRITE_SPEED |
| แผนการสนทนา |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
| ขั้นตอน |
android.permission.health.READ_STEPS
android.permission.health.WRITE_STEPS |
| แคลอรี่ที่เผาผลาญทั้งหมด |
android.permission.health.READ_TOTAL_CALORIES_BURNED
android.permission.health.WRite_TOTAL_CALORIES_BURNED |
| Vo2Max |
android.permission.health.READ_VO2_MAX
android.permission.health.WRITE_VO2_MAX |
| น้ำหนัก |
android.permission.health.READ_WEIGHT
android.permission.health.WRITE_WEIGHT |
| ที่ปัดวีลแชร์ |
android.permission.health.READ_WHEELCHAIR_PUSHES
android.permission.health.WRITE_WHEELCHAIR_PUSHES |
สำหรับ 1.0.0-alpha09 และต่ำกว่า
| ประเภทคลาสการบันทึก | การประกาศสิทธิ์เพื่ออ่านและเขียน |
|---|---|
| แคลอรี่ที่ใช้ไปในร่างกาย |
androidx.health.permission.ActiveCaloriesBurned.READ
androidx.health.permission.ActiveCaloriesBurned.WRITE |
| BasalBodyTemperature |
androidx.health.permission.BasalBodyTemperature.READ
androidx.health.permission.BasalBodyTemperature.WRITE |
| อัตราการเผาผลาญขณะพัก |
androidx.health.permission.BasalMetabolicRate.READ
androidx.health.permission.BasalMetabularRate.WRITE |
| น้ำตาลกลูโคสในเลือด |
androidx.health.permission.BloodGlucose.READ
androidx.health.permission.BloodGlucose.WRITE |
| ความดันเลือด |
androidx.health.permission.BloodPressure.READ
androidx.health.permission.BloodPressure.WRITE |
| ไขมันร่างกาย |
androidx.health.permission.BodyFat.READ
androidx.health.permission.BodyFat.WRITE |
| อุณหภูมิร่างกาย |
androidx.health.permission.BodyTemperature.READ
androidx.health.permission.BodyTemperature.WRITE |
| บอดี้วอเตอร์มัส |
androidx.health.permission.BodyWaterMass.READ
androidx.health.permission.BodyWaterMass.WRITE |
| มวลกระดูก |
androidx.health.permission.BoneMass.READ
androidx.health.permission.BoneMass.WRITE |
| CervicalMucus |
androidx.health.permission.CervicalMucus.READ
androidx.health.permission.CervicalMucus.WRITE |
| แผนการปั่นจักรยาน |
androidx.health.permission.CyclingPedalingCadence.READ
androidx.health.permission.CyclingPedalingCadence.WRITE |
| ระยะทาง |
androidx.health.permission.Distance.READ
androidx.health.permission.Distance.WRITE |
| ระดับความสูงที่เพิ่มขึ้น |
androidx.health.permission.Elevationสมัยศตวรรษที่ READ
androidx.health.permission.ElevationRuleed.WRITE |
| เซสชันการออกกำลังกาย |
androidx.health.permission.ExerciseSession.READ
androidx.health.permission.ExerciseSession.WRITE |
| ปีนชั้น |
androidx.health.permission.FloorsClimbed.READ
androidx.health.permission.FloorsClimbed.WRITE |
| อัตราการเต้นของหัวใจ |
androidx.health.permission.HeartRate.READ
androidx.health.permission.HeartRate.WRITE |
| HeartRateVariabilityRmssd |
androidx.health.permission.HeartRateVariabilityRmssd.READ
androidx.health.permission.HeartRateVariabilityRmssd.WRITE |
| ส่วนสูง |
androidx.health.permission.Height.READ
androidx.health.permission.Height.WRITE |
| ปริมาณน้ำที่ดื่ม |
androidx.health.permission.Hydration.READ
androidx.health.permission.Hydration.WRITE |
| IntermenstrualBleeding |
androidx.health.permission.IntermenstrualBleeding.READ
androidx.health.permission.IntermenstrualBleeding.WRITE |
| LeanBodyMass |
androidx.health.permission.LeanBodyMass.READ
androidx.health.permission.LeanBodyMass.WRITE |
| MenstruationFlow |
androidx.health.permission.MenstruationFlow.READ
androidx.health.permission.MenstruationFlow.WRITE |
| โภชนาการ |
androidx.health.permission.Nutrition.READ
androidx.health.permission.Nutrition.WRITE |
| การทดสอบไข่ |
androidx.health.permission.OvulationTest.READ
androidx.health.permission.OvulationTest.WRITE |
| ความอิ่มตัวของออกซิเจน |
androidx.health.permission.OxygenSaturation.READ
androidx.health.permission.OxygenSaturation.WRITE |
| อำนาจ |
androidx.health.permission.Power.READ
androidx.health.permission.Power.WRITE |
| อัตราการหายใจ |
androidx.health.permission.RespiratoryRate.READ
androidx.health.permission.RespiratoryRate.WRITE |
| อัตราการเต้นของหัวใจพัก |
androidx.health.permission.RestingHeartRate.READ
androidx.health.permission.RestingHeartRate.WRITE |
| กิจกรรมทางเพศ |
androidx.health.permission.GenderActivity.READ
androidx.health.permission.เกี่ยวกับเรื่องเพศ.เขียน |
| SleepSession |
androidx.health.permission.SleepSession.READ
androidx.health.permission.SleepSession.WRITE |
| ความเร็ว |
androidx.health.permission.Speed.READ
androidx.health.permission.Speed.WRITE |
| แผนการสนทนา |
androidx.health.permission.StepsCadence.READ
androidx.health.permission.StepsCadence.WRITE |
| ขั้นตอน |
androidx.health.permission.Steps.READ
androidx.health.permission.Steps.WRITE |
| แคลอรี่ที่เผาผลาญทั้งหมด |
androidx.health.permission.TotalCaloriesBurned.READ
androidx.health.permission.TotalCaloriesBurned.WRITE |
| Vo2Max |
androidx.health.permission.Vo2Max.READ
androidx.health.permission.Vo2Max.WRITE |
| น้ำหนัก |
androidx.health.permission.weight.READ
androidx.health.permission.weight.WRITE |
| ที่ปัดวีลแชร์ |
androidx.health.permission.WheelchairPushes.READ
androidx.health.permission.WheelchairPushes.WRITE |
ตรวจสอบประเภทข้อมูลและสิทธิ์
ในตอนนี้คุณมีการวางแผนประเภทข้อมูลและสิทธิ์แล้ว คุณสามารถติดตั้งใช้งาน ในระหว่างการพัฒนา
เมื่อตรวจสอบแอปก่อนอัปโหลดไปยัง Play Store ให้ตรวจสอบอีกครั้ง รายการประเภทข้อมูลและสิทธิ์ที่แอปของคุณต้องการ ซึ่งช่วยให้คุณ ประกาศการใช้ข้อมูลของแอปอย่างถูกต้อง
เมื่อคุณเตรียมเผยแพร่แอปใน Play Store ประกาศสิทธิ์เข้าถึงประเภทข้อมูล Health Connect ที่แอปของคุณ การใช้งาน ไม่เช่นนั้น ผู้ใช้อาจได้รับข้อความแจ้งพร้อมข้อความแสดงข้อผิดพลาดที่ระบุว่าแอปของคุณ เข้าถึงประเภทข้อมูล Health Connect ไม่ได้เนื่องจากจำเป็นต้องมีข้อมูลพิเศษ การอนุมัติ