พัฒนาประสบการณ์การใช้งานข้อมูลสำคัญด้วย Health Connect

หากต้องการสร้างแอปที่จัดการค่าสัญญาณชีพของผู้ใช้ คุณสามารถใช้ Health Connect เพื่อทำสิ่งต่างๆ เช่น

• อ่านข้อมูลค่าสัญญาณชีพ เช่น ความดันโลหิต อัตราการเต้นของหัวใจ และอุณหภูมิร่างกาย จาก แอปอื่นๆ
• เขียนข้อมูลค่าสัญญาณชีพที่แอปหรืออุปกรณ์ที่เชื่อมต่อบันทึกไว้
• ติดตามแนวโน้มและให้ข้อมูลเชิงลึกด้านสุขภาพโดยอิงตามข้อมูลสัญญาณชีพ

คู่มือนี้อธิบายวิธีทำงานกับประเภทข้อมูล Vitals โดยครอบคลุมสิทธิ์ เวิร์กโฟลว์การอ่านและการเขียน และแนวทางปฏิบัติแนะนำ

ภาพรวม: การสร้างเครื่องมือติดตาม Vitals ที่ครอบคลุม

คุณสร้างประสบการณ์การติดตามค่าสัญญาณชีพที่ครอบคลุมโดยใช้ Health Connect ได้โดยทำตามขั้นตอนหลักต่อไปนี้

• ขอสิทธิ์ที่เหมาะสมสำหรับประเภทข้อมูลค่าสัญญาณชีพ
• การเขียนข้อมูลค่าสัญญาณชีพโดยใช้บันทึก เช่น BloodPressureRecord HeartRateRecord และบันทึกค่าสัญญาณชีพอื่นๆ
• การอ่านข้อมูลค่าสัญญาณชีพเพื่อแสดง วิเคราะห์ หรือซิงค์
• การใช้การประมวลผลแบบกลุ่มเพื่อการเขียนและการอ่านข้อมูลที่มีประสิทธิภาพ

เวิร์กโฟลว์นี้ช่วยให้ทำงานร่วมกับแอป Health Connect อื่นๆ ได้และยืนยันการเข้าถึงข้อมูลที่ผู้ใช้ควบคุม

ก่อนเริ่มต้น

ก่อนที่จะใช้ฟีเจอร์ Vitals

• ผสานรวม Health Connect โดยใช้ทรัพยากร Dependency ที่เหมาะสม
• สร้างอินสแตนซ์ HealthConnectClient
• ยืนยันว่าแอปของคุณใช้โฟลว์สิทธิ์รันไทม์ตามสิทธิ์ด้านสุขภาพ

หัวข้อสำคัญ

ข้อมูลค่าสัญญาณชีพใน Health Connect แสดงด้วยประเภทบันทึกต่างๆ ซึ่งแต่ละประเภทสอดคล้องกับการวัดทางสรีรวิทยาที่เฉพาะเจาะจง โดยทั่วไปแล้ว ข้อมูลค่าสัญญาณชีพจะบันทึกเป็นข้อมูล ณ จุดใดจุดหนึ่งหรือข้อมูลตามช่วงเวลา ซึ่งแตกต่างจากเซสชันการออกกำลังกาย

ประเภทข้อมูลค่าสัญญาณชีพ

ข้อมูลค่าสัญญาณชีพจะแสดงตามประเภทระเบียนแต่ละรายการ ประเภทที่พบบ่อย ได้แก่

• BloodPressureRecord: แสดงค่าความดันโลหิตค่าเดียว รวมถึงความดันขณะหัวใจบีบและความดันขณะหัวใจคลาย และท่าทางของร่างกาย
• HeartRateRecord: แสดงการวัดอัตราการเต้นของหัวใจเป็นชุด
• RestingHeartRateRecord: แสดงการวัดอัตราการเต้นของหัวใจขณะพักเพียงครั้งเดียว
• BodyTemperatureRecord: แสดงค่าอุณหภูมิร่างกายค่าเดียว รวมถึงตำแหน่งการวัด
• BloodGlucoseRecord: แสดงค่าระดับน้ำตาลกลูโคสในเลือดค่าเดียว รวมถึง ความสัมพันธ์กับมื้ออาหารและแหล่งที่มาของตัวอย่าง
• OxygenSaturationRecord: แสดงค่าการอ่านค่าความอิ่มตัวของออกซิเจนในเลือดค่าเดียว
• RespiratoryRateRecord: แสดงการวัดอัตราการหายใจครั้งเดียว

ดูรายการประเภทข้อมูลทั้งหมดได้ที่ประเภทข้อมูล Health Connect

ข้อควรพิจารณาในการพัฒนา

ข้อมูลค่าสัญญาณชีพอาจมีความละเอียดอ่อน และแอปอาจต้องเขียนข้อมูลเพื่อตอบสนองต่อการวัดจากเซ็นเซอร์หรือข้อมูลจากผู้ใช้ หรือซิงค์ข้อมูลจากแบ็กเอนด์ สิทธิ์เป็นสิ่งสำคัญในการจัดการข้อมูลสัญญาณชีพ

สิทธิ์

แอปของคุณต้องขอสิทธิ์ที่เกี่ยวข้องของ Health Connect ก่อนที่จะอ่านหรือเขียนข้อมูลสัญญาณชีพ สิทธิ์ทั่วไปสำหรับค่าสัญญาณชีพ ได้แก่ ความดันโลหิต อัตราการเต้นของหัวใจ อุณหภูมิของร่างกาย น้ำตาลกลูโคสในเลือด ความอิ่มตัวของออกซิเจน และ อัตราการหายใจ ซึ่งประกอบด้วย

• ความดันโลหิต: สิทธิ์ในการอ่านและเขียนสำหรับ BloodPressureRecord
• อัตราการเต้นของหัวใจ: สิทธิ์อ่านและเขียนสำหรับ HeartRateRecord
• อัตราการเต้นของหัวใจขณะพัก: สิทธิ์ในการอ่านและเขียนสำหรับ RestingHeartRateRecord
• อุณหภูมิของร่างกาย: สิทธิ์ในการอ่านและเขียนสำหรับ BodyTemperatureRecord
• น้ำตาลกลูโคสในเลือด: สิทธิ์ในการอ่านและเขียนสำหรับ BloodGlucoseRecord
• ความอิ่มตัวของออกซิเจน: สิทธิ์อ่านและเขียนสำหรับ OxygenSaturationRecord
• อัตราการหายใจ: สิทธิ์การอ่านและการเขียนสำหรับ RespiratoryRateRecord

ตัวอย่างต่อไปนี้แสดงวิธีขอสิทธิ์สำหรับความดันโลหิต อัตราการเต้นของหัวใจ และอุณหภูมิร่างกาย

หลังจากสร้างอินสแตนซ์ไคลเอ็นต์แล้ว แอปของคุณต้องขอสิทธิ์จากผู้ใช้ ผู้ใช้ต้องได้รับอนุญาตให้ให้สิทธิ์หรือปฏิเสธสิทธิ์ได้ทุกเมื่อ

โดยให้สร้างชุดสิทธิ์สำหรับประเภทข้อมูลที่จำเป็น ตรวจสอบว่าได้ประกาศสิทธิ์ในชุดไว้ในไฟล์ Manifest ของ Android ก่อน

// Create a set of permissions for required data types
val PERMISSIONS =
    setOf(
  HealthPermission.getReadPermission(BloodPressureRecord::class),
  HealthPermission.getWritePermission(BloodPressureRecord::class),
  HealthPermission.getReadPermission(HeartRateRecord::class),
  HealthPermission.getWritePermission(HeartRateRecord::class),
  HealthPermission.getReadPermission(BodyTemperatureRecord::class),
  HealthPermission.getWritePermission(BodyTemperatureRecord::class)
)

ใช้ getGrantedPermissions เพื่อดูว่าแอปของคุณได้รับสิทธิ์ที่จำเป็นแล้วหรือไม่ หากไม่มี ให้ใช้ createRequestPermissionResultContract เพื่อขอสิทธิ์เหล่านั้น ซึ่งจะแสดงหน้าจอขอสิทธิ์ของ Health Connect

// Create the permissions launcher
val requestPermissionActivityContract = PermissionController.createRequestPermissionResultContract()

val requestPermissions = registerForActivityResult(requestPermissionActivityContract) { granted ->
  if (granted.containsAll(PERMISSIONS)) {
    // Permissions successfully granted
  } else {
    // Lack of required permissions
  }
}

suspend fun checkPermissionsAndRun(healthConnectClient: HealthConnectClient) {
  val granted = healthConnectClient.permissionController.getGrantedPermissions()
  if (granted.containsAll(PERMISSIONS)) {
    // Permissions already granted; proceed with inserting or reading data
  } else {
    requestPermissions.launch(PERMISSIONS)
  }
}

เนื่องจากผู้ใช้สามารถให้หรือเพิกถอนสิทธิ์ได้ทุกเมื่อ แอปของคุณจึงต้อง ตรวจสอบสิทธิ์ทุกครั้งก่อนที่จะใช้สิทธิ์ และจัดการสถานการณ์ที่ สิทธิ์หายไป

หากต้องการขอสิทธิ์ ให้เรียกใช้ฟังก์ชัน checkPermissionsAndRun ดังนี้

if (!granted.containsAll(PERMISSIONS)) {
    requestPermissions.launch(PERMISSIONS)
    // Check if required permissions are not granted, and return
  }
// Permissions already granted; proceed with inserting or reading data

หากต้องการขอสิทธิ์สำหรับข้อมูลประเภทเดียวเท่านั้น เช่น ความดันโลหิต ให้รวมเฉพาะข้อมูลประเภทนั้นไว้ในชุดสิทธิ์

การเข้าถึงความดันโลหิตได้รับการคุ้มครองโดยสิทธิ์ต่อไปนี้

• android.permission.health.READ_BLOOD_PRESSURE
• android.permission.health.WRITE_BLOOD_PRESSURE

หากต้องการเพิ่มความสามารถในการวัดความดันเลือดลงในแอป ให้เริ่มด้วยการขอสิทธิ์สำหรับประเภทข้อมูล BloodPressureRecord

สิทธิ์ที่คุณต้องประกาศเพื่อเขียนความดันโลหิตมีดังนี้

<application>
  <uses-permission
android:name="android.permission.health.WRITE_BLOOD_PRESSURE" />
...
</application>

หากต้องการอ่านค่าความดันโลหิต คุณต้องขอสิทธิ์ต่อไปนี้

<application>
  <uses-permission
android:name="android.permission.health.READ_BLOOD_PRESSURE" />
...
</application>

เขียนข้อมูลสัญญาณชีพ

ส่วนนี้จะอธิบายวิธีเขียนข้อมูลค่าสัญญาณชีพไปยัง Health Connect โดยปกติแล้ว ระบบจะเขียนข้อมูลค่าสัญญาณชีพ เป็นระเบียนแต่ละรายการ หากคุณเขียนหลายระเบียน พร้อมกัน เช่น การซิงค์จากเซ็นเซอร์หรือแบ็กเอนด์ ให้ใช้การจัดกลุ่ม

ตัวอย่างการเขียน BloodPressureRecord

suspend fun writeBloodPressureRecord(healthConnectClient: HealthConnectClient) {
    val record = BloodPressureRecord(
        time = Instant.now(),
        zoneOffset = ZoneOffset.UTC,
        systolic = Pressure.millimetersOfMercury(120.0),
        diastolic = Pressure.millimetersOfMercury(80.0),
        bodyPosition = BloodPressureRecord.BODY_POSITION_SITTING_DOWN,
        measurementLocation = BloodPressureRecord.MEASUREMENT_LOCATION_LEFT_WRIST
    )
    healthConnectClient.insertRecords(listOf(record))
}

การเขียนแบบกลุ่ม

หากแอปต้องเขียนจุดข้อมูลหลายจุด เช่น การซิงค์ข้อมูลจาก อุปกรณ์ที่เชื่อมต่อหรือบริการแบ็กเอนด์ คุณควรเขียนเป็นกลุ่มเพื่อปรับปรุง ประสิทธิภาพและลดการใช้แบตเตอรี่ Health Connect รองรับการบันทึกได้สูงสุด 1,000 รายการในคำขอเขียนรายการเดียว

โค้ดต่อไปนี้แสดงวิธีเขียนหลายระเบียนพร้อมกันในโหมดเป็นกลุ่ม

suspend fun writeBatchRecords(healthConnectClient: HealthConnectClient) {
    val bloodPressureRecord = BloodPressureRecord(
        time = Instant.now(),
        zoneOffset = ZoneOffset.UTC,
        systolic = Pressure.millimetersOfMercury(120.0),
        diastolic = Pressure.millimetersOfMercury(80.0),
        bodyPosition = BloodPressureRecord.BODY_POSITION_SITTING_DOWN,
        measurementLocation = BloodPressureRecord.MEASUREMENT_LOCATION_LEFT_WRIST
    )
    val heartRateRecord = HeartRateRecord(
        startTime = Instant.now().minusSeconds(60),
        startZoneOffset = ZoneOffset.UTC,
        endTime = Instant.now(),
        endZoneOffset = ZoneOffset.UTC,
        samples = listOf(HeartRateRecord.Sample(time = Instant.now().minusSeconds(30), beatsPerMinute = 80))
    )
    healthConnectClient.insertRecords(listOf(bloodPressureRecord, heartRateRecord))
}

การอ่านข้อมูลค่าสัญญาณชีพ

แอปสามารถอ่านข้อมูลค่าสัญญาณชีพเพื่อแสดงการวัดผล วิเคราะห์แนวโน้ม หรือซิงค์ข้อมูลกับเซิร์ฟเวอร์ภายนอกได้ หากต้องการอ่านค่าสัญญาณชีพ ให้ใช้ ReadRecordsRequest ที่มีประเภทระเบียนที่เฉพาะเจาะจงและกรองตามช่วงเวลา

ตัวอย่างการอ่านข้อมูล BloodPressureRecord

suspend fun readBloodPressureRecords(
    healthConnectClient: HealthConnectClient,
    startTime: Instant,
    endTime: Instant
) {
    val response = healthConnectClient.readRecords(
        ReadRecordsRequest(
            recordType = BloodPressureRecord::class,
            timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
        )
    )

    for (record in response.records) {
        // Process each blood pressure record
        val systolic = record.systolic
        val diastolic = record.diastolic
    }
}

หากต้องการซิงค์ข้อมูลค่าสัญญาณชีพกับเซิร์ฟเวอร์แบ็กเอนด์ หรืออัปเดตพื้นที่เก็บข้อมูลของแอปให้เป็นปัจจุบันด้วย Health Connect ให้ใช้ ChangeLogs ซึ่งช่วยให้คุณดึงข้อมูลรายการระเบียนที่แทรก อัปเดต หรือลบตั้งแต่ช่วงเวลาที่เฉพาะเจาะจงได้ ซึ่งมีประสิทธิภาพมากกว่าการติดตามการเปลี่ยนแปลงด้วยตนเองหรือการอ่านข้อมูลทั้งหมดซ้ำๆ ดูข้อมูลเพิ่มเติมได้ที่ซิงค์ข้อมูลกับ Health Connect

แนวทางปฏิบัติแนะนำ

โปรดทำตามหลักเกณฑ์ต่อไปนี้เพื่อปรับปรุงความน่าเชื่อถือของข้อมูลและประสบการณ์ของผู้ใช้

• คำขอเขียนแบบกลุ่ม: หากต้องการลดค่าใช้จ่ายอินพุต/เอาต์พุตและรักษาอายุการใช้งานแบตเตอรี่ ให้จัดกลุ่มจุดข้อมูลเป็นinsertRecordsการเรียกใช้เดียวที่มีชุดข้อมูลสูงสุด 1,000 รายการ แทนที่จะเขียนแต่ละจุดแยกกัน
• เขียนข้อมูลบ่อยครั้งระหว่างการติดตามแบบเรียลไทม์: สำหรับการอัปเดตจากเซ็นเซอร์บ่อยครั้ง (เช่น เครื่องตรวจน้ำตาลแบบต่อเนื่องหรือเครื่องวัดอัตราการเต้นของหัวใจ) ให้เขียนข้อมูลเป็นชุดในช่วงเวลาไม่เกิน 15 นาทีเพื่อปรับสมดุลการอัปเดตแบบเรียลไทม์กับประสิทธิภาพของแบตเตอรี่
• ใช้ WorkManager สำหรับการซิงค์ในเบื้องหลัง: ใช้ WorkManager สำหรับการเขียนที่เลื่อนออกไป เช่น การซิงค์ข้อมูลจากอุปกรณ์ที่ใช้ร่วมกันหรือบริการแบ็กเอนด์ ตั้งเป้าหมายเป็นช่วงเวลา 15 นาทีสำหรับการเขียนแบบกลุ่ม
• หลีกเลี่ยงการเขียนข้อมูลที่ซ้ำกัน: ใช้ Client ID: เมื่อสร้างบันทึก ให้ตั้งค่า metadata.clientRecordId Health Connect ใช้ข้อมูลนี้เพื่อระบุบันทึกที่ไม่ซ้ำกัน หากคุณพยายามเขียนบันทึกที่มี clientRecordId อยู่แล้ว Health Connect จะไม่สนใจรายการที่ซ้ำกันหรืออัปเดตบันทึกที่มีอยู่แทนที่จะสร้างรายการใหม่ การตั้งค่า metadata.clientRecordId เป็นวิธีที่มีประสิทธิภาพที่สุดในการป้องกันรายการที่ซ้ำกันระหว่างการลองซิงค์อีกครั้งหรือการติดตั้งแอปใหม่
  

  val record = StepsRecord(
      count = 100,
      startTime = startTime,
      endTime = endTime,
      startZoneOffset = ZoneOffset.UTC,
      endZoneOffset = ZoneOffset.UTC,
      metadata = Metadata(
          // Use a unique ID from your own database
          clientRecordId = "daily_steps_2023_10_27_user_123"
      )
  )

• ตรวจสอบข้อมูลที่มีอยู่: ก่อนซิงค์ข้อมูล ให้ค้นหาระเบียนใน Health Connect ภายในช่วงเวลาการซิงค์เพื่อดูว่ามีข้อมูลจากแอปอยู่แล้วหรือไม่ เพื่อหลีกเลี่ยงการซ้ำหรือการเขียนทับข้อมูลใหม่กว่า
• ระบุเหตุผลที่ชัดเจนสำหรับสิทธิ์: ใช้โฟลว์ Permission.createIntent เพื่ออธิบายเหตุผลที่แอปของคุณต้องเข้าถึงข้อมูลสุขภาพ เช่น "เพื่อตรวจสอบแนวโน้มความดันโลหิตและให้ข้อมูลเชิงลึก"
• จัดแนวการประทับเวลากับการวัด: ตรวจสอบว่าการประทับเวลาของบันทึกแสดงเวลาที่ทำการวัดอย่างถูกต้อง สําหรับข้อมูลช่วงเวลา เช่น HeartRateRecord ให้ตรวจสอบว่า startTime และ endTime ถูกต้อง

การทดสอบ

โปรดทำตามกลยุทธ์การทดสอบเหล่านี้และดูเอกสารประกอบทดสอบกรณีการใช้งานยอดนิยมอย่างเป็นทางการเพื่อยืนยันความถูกต้องของข้อมูลและประสบการณ์การใช้งานคุณภาพสูง

เครื่องมือยืนยัน

• กล่องเครื่องมือ Health Connect: ใช้แอปคู่หูนี้เพื่อตรวจสอบระเบียนด้วยตนเอง ลบข้อมูลทดสอบ และจำลองการเปลี่ยนแปลงในฐานข้อมูล ซึ่งเป็น วิธีที่ดีที่สุดในการยืนยันว่าระบบจัดเก็บระเบียนของคุณอย่างถูกต้อง
• การทำ Unit Test ด้วย FakeHealthConnectClient: ใช้ไลบรารีการทดสอบ เพื่อยืนยันวิธีที่แอปจัดการกรณีขอบ เช่น การเพิกถอนสิทธิ์หรือข้อยกเว้น API โดยไม่ต้องใช้อุปกรณ์จริง

รายการตรวจสอบคุณภาพ

สถาปัตยกรรมทั่วไป

โดยปกติแล้วการติดตั้งใช้งาน Vitals จะรวมถึงสิ่งต่อไปนี้

การแก้ปัญหา

ขั้นตอนการแก้ไขข้อบกพร่องที่พบบ่อย