วางแผนและตรวจสอบประเภทข้อมูล Health Connect

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 ไม่ได้เนื่องจากจำเป็นต้องมีข้อมูลพิเศษ การอนุมัติ