พัฒนาประสบการณ์การออกกำลังกายด้วย Health Connect

คู่มือนี้ใช้ได้กับ Health Connect เวอร์ชัน 1.1.0 ขึ้นไป

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

  • เขียนข้อมูลเซสชันการออกกำลังกาย
  • เขียนเส้นทางการออกกำลังกาย
  • เขียนเมตริกการออกกำลังกาย เช่น อัตราการเต้นของหัวใจ ความเร็ว และระยะทาง
  • อ่านข้อมูลการออกกำลังกายจากแอปอื่นๆ

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

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

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

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

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

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

ก่อนใช้ฟีเจอร์การออกกำลังกาย ให้ทำดังนี้

แนวคิดสำคัญ

Health Connect แสดงข้อมูลการออกกำลังกายโดยใช้องค์ประกอบหลัก 2-3 อย่าง ExerciseSessionRecord ทำหน้าที่เป็นบันทึกส่วนกลางสำหรับการออกกำลังกาย โดยมีรายละเอียดต่างๆ เช่น เวลาเริ่มต้นหรือสิ้นสุด และประเภทการออกกำลังกาย ในระหว่างเซสชัน ระบบจะบันทึกข้อมูลประเภทต่างๆ เช่น HeartRateRecord หรือ SpeedRecord สำหรับกิจกรรมกลางแจ้ง ExerciseRoute จะจัดเก็บข้อมูล GPS ซึ่งลิงก์กับเซสชันที่เกี่ยวข้อง

เซสชันการออกกำลังกาย

ExerciseSessionRecord เป็นบันทึกส่วนกลางสำหรับข้อมูลการออกกำลังกาย ซึ่งแสดงถึงเซสชันการออกกำลังกาย 1 เซสชัน ระเบียนแต่ละรายการจะจัดเก็บข้อมูลต่อไปนี้

  • startTime
  • endTime
  • exerciseType
  • ข้อมูลเมตาของเซสชันที่ไม่บังคับ (ชื่อ, บันทึก)

ExerciseSessionRecord ยังมีเส้นทางการออกกำลังกาย รอบ และเซกเมนต์เป็นส่วนหนึ่งของข้อมูลด้วย นอกจากนี้ ระบบยังสามารถบันทึกข้อมูลประเภทอื่นๆ เช่น HeartRateRecord หรือ SpeedRecord ในระหว่างเซสชันและเชื่อมโยงกับเซสชันนั้นได้

ประเภทข้อมูลที่เกี่ยวข้อง

ข้อมูลที่เชื่อมโยงกับเซสชันการออกกำลังกายจะแสดงตามประเภทระเบียนแต่ละประเภท ประเภทที่พบบ่อยมีดังนี้

  • HeartRateRecord: แสดงชุดการวัดอัตราการเต้นของหัวใจ
  • SpeedRecord: แสดงชุดการวัดความเร็ว
  • DistanceRecord: แสดงระยะทางที่ครอบคลุมระหว่างการอ่านค่า
  • TotalCaloriesBurnedRecord: แสดงแคลอรี่ที่ใช้ไปทั้งหมดระหว่างการอ่านค่า
  • ElevationGainedRecord: แสดงความสูงสะสมระหว่างการอ่านค่า
  • StepsCadenceRecord: แสดงจังหวะการก้าวระหว่างการอ่านค่า
  • PowerRecord: แสดงกำลังที่ใช้ระหว่างการอ่านค่า ซึ่งพบได้ทั่วไปในกิจกรรมต่างๆ เช่น การปั่นจักรยาน

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

เส้นทางการออกกำลังกาย

คุณเชื่อมโยงเส้นทางกับการออกกำลังกายกลางแจ้งได้โดยใช้ ExerciseRoute เส้นทางประกอบด้วยออบเจ็กต์ ExerciseRoute.Location ตามลำดับ ซึ่งแต่ละออบเจ็กต์ประกอบด้วยข้อมูลต่อไปนี้

  • ละติจูดและลองจิจูด
  • ระดับความสูง (ไม่บังคับ)
  • ทิศทาง (ไม่บังคับ)
  • ข้อมูลความแม่นยำ
  • การประทับเวลา

เส้นทางเซสชันลิงก์

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

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

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

การดำเนินการในเบื้องหลัง

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

  • บริการที่ทำงานอยู่เบื้องหน้าสำหรับการสุ่มตัวอย่างตำแหน่งและเซ็นเซอร์
  • WorkManager สำหรับการเขียนหรือการซิงค์ที่เลื่อนออกไป
  • กลยุทธ์การรวมกลุ่มสำหรับการเขียนระเบียนปกติ

รักษาความต่อเนื่องโดยใช้รหัสเซสชันที่สอดคล้องกันในการเขียนทั้งหมด

สิทธิ์

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

  • เซสชันการออกกำลังกาย: สิทธิ์อ่านและเขียนสำหรับ ExerciseSessionRecord
  • เส้นทางการออกกำลังกาย: สิทธิ์อ่านและสิทธิ์เขียนสำหรับ ExerciseRoute
  • อัตราการเต้นของหัวใจ: สิทธิ์อ่านและเขียนสำหรับ HeartRateRecord
  • ความเร็ว: สิทธิ์อ่านและเขียนสำหรับ SpeedRecord
  • ระยะทาง: สิทธิ์อ่านและเขียนสำหรับ DistanceRecord
  • แคลอรี: สิทธิ์อ่านและเขียนสำหรับ TotalCaloriesBurnedRecord
  • ความสูงสะสม: สิทธิ์อ่านและเขียนสำหรับ ElevationGainedRecord
  • Steps Cadence: สิทธิ์อ่านและสิทธิ์เขียนสำหรับ StepsCadenceRecord
  • Power: สิทธิ์อ่านและสิทธิ์เขียนสำหรับ PowerRecord
  • ขั้นตอน: สิทธิ์อ่านและสิทธิ์เขียนสำหรับ StepsRecord

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

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

val permissions =
    setOf(
        HealthPermission.getReadPermission(ExerciseSessionRecord::class),
        HealthPermission.getWritePermission(ExerciseSessionRecord::class),
        HealthPermission.getReadPermission(HeartRateRecord::class),
        HealthPermission.getWritePermission(HeartRateRecord::class),
        HealthPermission.getReadPermission(SpeedRecord::class),
        HealthPermission.getWritePermission(SpeedRecord::class),
        HealthPermission.getReadPermission(DistanceRecord::class),
        HealthPermission.getWritePermission(DistanceRecord::class),
        HealthPermission.getReadPermission(TotalCaloriesBurnedRecord::class),
        HealthPermission.getWritePermission(TotalCaloriesBurnedRecord::class),
        HealthPermission.getReadPermission(StepsRecord::class),
        HealthPermission.getWritePermission(StepsRecord::class)
    )
ใช้ getGrantedPermissions เพื่อดูว่าแอปของคุณได้รับสิทธิ์ที่จำเป็นแล้วหรือยัง หากไม่มี ให้ใช้ createRequestPermissionResultContract เพื่อขอสิทธิ์เหล่านั้น หน้าจอแสดงสิทธิ์ของ Health Connect จะปรากฏขึ้น
val permissions = setOf(
        HealthPermission.getReadPermission(StepsRecord::class),
        HealthPermission.getWritePermission(StepsRecord::class),
        HealthPermission.getReadPermission(HeartRateRecord::class),
        HealthPermission.getWritePermission(HeartRateRecord::class)
    )

val requestPermissionsLauncher = rememberLauncherForActivityResult(
    contract = PermissionController.createRequestPermissionResultContract()
) { grantedPermissions ->
    if (grantedPermissions.containsAll(permissions)) {
        coroutineScope.launch { snackbarHostState.showSnackbar("Permissions granted!") }
    } else {
        coroutineScope.launch { snackbarHostState.showSnackbar("Permissions denied.") }
    }
}
เนื่องจากผู้ใช้สามารถให้หรือเพิกถอนสิทธิ์ได้ทุกเมื่อ แอปของคุณจึงต้องตรวจสอบสิทธิ์ทุกครั้งก่อนใช้งานและจัดการสถานการณ์ที่สิทธิ์หายไป

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

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

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

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

  • android.permission.health.READ_HEART_RATE
  • android.permission.health.WRITE_HEART_RATE

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

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

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

หากต้องการอ่านอัตราการเต้นของหัวใจ คุณต้องขอสิทธิ์ต่อไปนี้

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

ใช้เซสชันการออกกำลังกาย

ส่วนนี้จะอธิบายเวิร์กโฟลว์ที่แนะนำสำหรับการบันทึกข้อมูลการออกกำลังกาย

เริ่มเซสชัน

วิธีสร้างการออกกำลังกายใหม่

  1. สร้างรหัสเซสชันที่ไม่ซ้ำกัน: ตรวจสอบว่ารหัสนี้เสถียร หากกระบวนการของแอปถูกปิดและรีสตาร์ท คุณต้องกลับมาใช้รหัสเดิมได้เพื่อป้องกันไม่ให้เซสชันกระจัดกระจาย
  2. ตั้งค่า metadata.clientRecordId เพื่อป้องกันไม่ให้เกิดข้อมูลซ้ำระหว่างการลองซิงค์อีกครั้ง
  3. เขียน ExerciseSessionRecord: ระบุเวลาเริ่มต้น
  4. เริ่มรวบรวมประเภทข้อมูลและข้อมูล GPS: เริ่มรวบรวมข้อมูลเหล่านี้หลังจากเริ่มต้นบันทึกเซสชันเรียบร้อยแล้วเท่านั้น

ตัวอย่าง

val sessionClientId = UUID.randomUUID().toString()
val zoneOffset = ZoneOffset.systemDefault().rules.getOffset(startTime)

val session =   ExerciseSessionRecord(
    startTime = startTime,
    startZoneOffset = zoneOffset,
    endTime = startTime.plusSeconds(3600),
    endZoneOffset = zoneOffset,
    exerciseType = ExerciseSessionRecord.EXERCISE_TYPE_RUNNING,
    metadata = Metadata.activelyRecorded(clientRecordId = sessionClientId, device = Device(type = Device.TYPE_PHONE)),
)

healthConnectClient.insertRecords(listOf(session))

บันทึกเส้นทางการออกกำลังกาย

ดูข้อมูลเพิ่มเติมเกี่ยวกับคำแนะนำในการอ่านได้ที่อ่านข้อมูลดิบ

เมื่อบันทึกเส้นทางการออกกำลังกาย คุณควรจัดกลุ่มข้อมูล ซึ่งหมายความว่าแทนที่จะบันทึกจุด GPS ทุกจุดเมื่อเกิดขึ้น คุณจะรวบรวมกลุ่มจุดและบันทึกทั้งหมดพร้อมกันในการเรียกใช้ครั้งเดียว

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

โค้ดต่อไปนี้แสดงวิธีบันทึกเป็นกลุ่ม

// 1. Create a list to hold your route locations
val routeLocations = mutableListOf<ExerciseRoute.Location>()

// 2. Add points to your list as the exercise happens
routeLocations.add(
    ExerciseRoute.Location(
        time = Instant.now(),
        latitude = 37.7749,
        longitude = -122.4194
    )
)

// ... keep adding points over a period of time ...

// 3. Save the whole list at once (Batching)
val session = ExerciseSessionRecord(
    startTime = startTime,
    endTime = endTime,
    exerciseType = ExerciseSessionRecord.EXERCISE_TYPE_RUNNING,
    // We pass the whole list here
    exerciseRoute = ExerciseRoute(routeLocations)
)

healthConnectClient.insertRecords(listOf(session))

สิ้นสุดเซสชัน

หลังจากหยุดการเก็บรวบรวมข้อมูลแล้ว สิ่งที่จะเกิดขึ้นมีดังนี้

  • อัปเดตระเบียน: แอปของคุณอัปเดต ExerciseSessionRecord ด้วย endTime
  • สรุปข้อมูล: คำนวณค่าสรุป (เช่น ระยะทางรวมหรือความเร็วเฉลี่ย) และเขียนเป็นบันทึกเพิ่มเติม (ไม่บังคับ)
val finishedSession = session.copy(endTime = Instant.now())
healthConnectClient.updateRecords(listOf(finishedSession))

กำลังอ่านข้อมูลการออกกำลังกาย

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

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

อ่านเซสชัน

หากต้องการอ่านเซสชันการออกกำลังกาย ให้ใช้ ReadRecordsRequest โดยมี ExerciseSessionRecord เป็นประเภท โดยปกติแล้ว คุณจะกรองข้อมูลนี้ตามช่วงเวลาที่เจาะจง

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

    for (exerciseRecord in response.records) {
        // Process each session
        val exerciseType = exerciseRecord.exerciseType
        val notes = exerciseRecord.notes
    }
}

อ่านเส้นทาง

แม้ว่าข้อมูล ExerciseRoute จะเขียนเป็นส่วนหนึ่งของเซสชันการออกกำลังกาย แต่ก็ต้องอ่านแยกต่างหาก ใช้เมธอด getExerciseRoute() กับรหัสของเซสชันเพื่ออ่านข้อมูลเส้นทางของเซสชันนั้น

suspend fun readExerciseRoute(
    healthConnectClient: HealthConnectClient,
    exerciseSessionRecord: ExerciseSessionRecord
) {
    // Check if the session has a route
    val route = healthConnectClient.getExerciseRoute(
        exerciseSessionRecordId = exerciseSessionRecord.metadata.id
    )

    when (route) {
        is ExerciseRouteResponse.Success -> {
            val locations = route.exerciseRoute.locations
            for (location in locations) {
                // Use latitude, longitude, and altitude
            }
        }
        is ExerciseRouteResponse.NoData -> {
            // Handle case where no route exists
        }
        is ExerciseRouteResponse.ConsentRequired -> {
            // Handle case where permissions are missing
        }
    }
}

ประเภทข้อมูลการอ่าน

หากต้องการอ่านข้อมูลที่ละเอียดเฉพาะเจาะจง (เช่น อัตราการเต้นของหัวใจ) ที่เกิดขึ้นระหว่างเซสชัน ให้ใช้ startTime และ endTime ของเซสชันเพื่อกรองคำขอสำหรับประเภทข้อมูลนั้น

suspend fun readHeartRateData(
    healthConnectClient: HealthConnectClient,
    exerciseSession: ExerciseSessionRecord
) {
    val response = healthConnectClient.readRecords(
        ReadRecordsRequest(
            recordType = HeartRateRecord::class,
            timeRangeFilter = TimeRangeFilter.between(
                exerciseSession.startTime,
                exerciseSession.endTime
            )
        )
    )

    for (heartRateRecord in response.records) {
        for (sample in heartRateRecord.samples) {
            val bpm = sample.beatsPerMinute
        }
    }
}

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

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

  • เขียนข้อมูลบ่อยๆ ในระหว่างการติดตามกิจกรรม: สำหรับการติดตามกิจกรรม ให้เขียนข้อมูลเมื่อพร้อมใช้งานหรือในช่วงเวลาสูงสุด 15 นาที
  • ใช้ WorkManager สำหรับการซิงค์ในเบื้องหลัง: ใช้ WorkManager สำหรับการเขียนที่เลื่อนออกไป ตั้งเป้าไว้ที่ช่วงเวลา 15 นาทีเพื่อสร้างสมดุลระหว่างข้อมูลแบบเรียลไทม์และประสิทธิภาพของแบตเตอรี่
  • คำขอเขียนแบบกลุ่ม: อย่าเขียนเหตุการณ์เซ็นเซอร์แต่ละรายการแยกกัน แบ่งคำขอออกเป็นส่วนๆ Health Connect จัดการบันทึกได้สูงสุด 1,000 รายการต่อคำขอเขียน
  • ใช้รหัสเซสชันที่คงที่และไม่ซ้ำกัน: ใช้ตัวระบุที่สอดคล้องกันสำหรับเซสชัน หากมีการแก้ไขหรืออัปเดตเซสชัน การใช้รหัสเดียวกันจะช่วยป้องกันไม่ให้ระบบถือว่าเซสชันดังกล่าวเป็นเซสชันใหม่ที่แยกต่างหาก
  • ใช้การจัดกลุ่มสำหรับทั้งประเภทข้อมูลและจุดบนเส้นทาง: เพื่อลดภาระงานอินพุต/เอาต์พุตและประหยัดแบตเตอรี่ ให้จัดกลุ่มจุดข้อมูลเป็นการเรียก insertRecords ครั้งเดียวแทนที่จะเขียนแต่ละจุดแยกกัน
  • หลีกเลี่ยงการเขียนข้อมูลที่ซ้ำกัน: ใช้รหัสไคลเอ็นต์: เมื่อสร้างระเบียน ให้ตั้งค่า 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"
        )
    )
  • ตรวจสอบข้อมูลที่มีอยู่: ก่อนซิงค์ ให้ค้นหาช่วงเวลาเพื่อดูว่ามีบันทึกจากแอปของคุณอยู่แล้วหรือไม่
  • ตรวจสอบความแม่นยำของ GPS: กรองตัวอย่าง GPS ที่มีความแม่นยำต่ำออก (เช่น จุดที่มีรัศมีความแม่นยำในแนวนอนสูง) ก่อนเขียนลงใน ExerciseRoute เพื่อยืนยันว่าแผนที่ดูสะอาดตาและเป็นมืออาชีพ
  • ตรวจสอบว่าการประทับเวลาไม่ทับซ้อนกัน: ตรวจสอบว่าเซสชันใหม่ไม่ได้เริ่มต้นก่อนที่เซสชันก่อนหน้าจะสิ้นสุดลง เซสชันที่ทับซ้อนกันอาจทำให้เกิดความขัดแย้งในแดชบอร์ดฟิตเนสและการคำนวณสรุป
  • ระบุเหตุผลที่ชัดเจนในการขอสิทธิ์: ใช้ขั้นตอน Permission.createIntent เพื่ออธิบายเหตุผลที่แอปต้องเข้าถึงข้อมูลสุขภาพ เช่น "เพื่อติดตามแนวโน้มความดันโลหิตและให้ข้อมูลเชิงลึก"
  • รองรับการหยุดชั่วคราวและการกลับมาทำงานอีกครั้ง: ยืนยันว่าแอปของคุณจัดการการหยุดชั่วคราวได้อย่างถูกต้อง เมื่อผู้ใช้หยุดชั่วคราว ให้หยุดรวบรวมจุดบนเส้นทางและประเภทข้อมูลเพื่อให้ความเร็วและระยะเวลาเฉลี่ยยังคงถูกต้อง
  • ทดสอบเซสชันที่ใช้เวลานาน: ตรวจสอบการใช้แบตเตอรี่ในระหว่างเซสชันที่ใช้เวลานานหลายชั่วโมงเพื่อยืนยันว่าช่วงการจัดกลุ่มและการใช้เซ็นเซอร์ไม่ทำให้อุปกรณ์หมดพลังงาน
  • ปรับการประทับเวลาให้สอดคล้องกับอัตราของเซ็นเซอร์: จับคู่การประทับเวลาของบันทึกกับความถี่จริงของเซ็นเซอร์เพื่อรักษาความแม่นยำสูงของข้อมูล

การทดสอบ

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

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

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

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

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

การติดตั้งใช้งานการออกกำลังกายมักประกอบด้วยข้อมูลต่อไปนี้

ส่วนประกอบ จัดการ
ตัวควบคุมเซสชัน สถานะเซสชัน
ตัวจับเวลา
ตรรกะการจัดกลุ่ม
ตัวควบคุมประเภทข้อมูล
การสุ่มตัวอย่างตำแหน่ง
เลเยอร์ที่เก็บ (รวมการดำเนินการของ Health Connect) แทรกเซสชัน
แทรกประเภทข้อมูล
แทรกจุดบนเส้นทาง
อ่านสรุปเซสชัน
ชั้น UI (จอแสดงผล): ระยะเวลา
ประเภทข้อมูลแบบเรียลไทม์
ตัวอย่างแผนที่
การคำนวณการแยก
เส้นทางตาม GPS แบบเรียลไทม์

การแก้ปัญหา

ลักษณะปัญหา สาเหตุที่เป็นไปได้ ความละเอียด
เส้นทางไม่ได้เชื่อมโยงกับเซสชัน รหัสเซสชันหรือช่วงเวลาไม่ตรงกัน ตรวจสอบว่า ExerciseRoute เขียนขึ้นโดยมีช่วงเวลาที่อยู่ภายในระยะเวลาของ ExerciseSessionRecord ทั้งหมด ตรวจสอบว่าคุณใช้รหัสที่สอดคล้องกันหากอ้างอิงเซสชันในภายหลัง ดูการบันทึกเส้นทางการออกกำลังกาย
ประเภทข้อมูลที่ขาดหายไป (เช่น อัตราการเต้นของหัวใจ) ไม่มีสิทธิ์เขียนหรือตัวกรองเวลาไม่ถูกต้อง ตรวจสอบว่าคุณได้ขอและผู้ใช้ได้ให้สิทธิ์เข้าถึงประเภทข้อมูลที่เฉพาะเจาะจงแล้ว ยืนยันว่า ReadRecordsRequest ใช้ TimeRangeFilter ที่ตรงกับเซสชัน ดูสิทธิ์
เขียนเซสชันไม่สำเร็จ การประทับเวลาซ้อนทับกัน Health Connect อาจปฏิเสธบันทึกที่ทับซ้อนกับข้อมูลที่มีอยู่จากแอปเดียวกัน ตรวจสอบว่า startTime ของเซสชันใหม่อยู่หลัง endTime ของเซสชันก่อนหน้า
ไม่มีข้อมูล GPS ที่บันทึกไว้ บริการที่ทำงานอยู่เบื้องหน้าถูกปิดหรือไม่มีการใช้งาน หากต้องการรวบรวมข้อมูลขณะที่หน้าจอปิดอยู่ คุณต้องใช้บริการที่ทำงานอยู่เบื้องหน้าที่มีแอตทริบิวต์ foregroundServiceType="health" หรือตำแหน่ง
ระเบียนที่ซ้ำกันปรากฏขึ้น ไม่มี clientRecordId กำหนด clientRecordId ที่ไม่ซ้ำกันใน Metadata ของแต่ละระเบียน ซึ่งจะช่วยให้ Health Connect ทำการกรองข้อมูลที่ซ้ำกันออกได้หากมีการเขียนข้อมูลเดียวกัน 2 ครั้งระหว่างการลองซิงค์อีกครั้ง ดูแนวทางปฏิบัติแนะนำ

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

ตรวจสอบสถานะสิทธิ์ เรียกใช้ getPermissionStatus() ทุกครั้งก่อนพยายามดำเนินการอ่านหรือเขียน ผู้ใช้สามารถเพิกถอนสิทธิ์ในการตั้งค่าระบบได้ทุกเมื่อ
ยืนยันโหมดการดำเนินการ หากแอปไม่ได้รวบรวมข้อมูลในเบื้องหลัง ให้ตรวจสอบว่าคุณได้ประกาศสิทธิ์ที่ถูกต้องในไฟล์ AndroidManifest.xml และผู้ใช้ไม่ได้ตั้งค่าแอปให้อยู่ในโหมด "จำกัดแบตเตอรี่"