คู่มือนี้ใช้ได้กับ Health Connect เวอร์ชัน 1.1.0 ขึ้นไป
หากต้องการสร้างประสบการณ์การออกกำลังกายในแอป คุณสามารถใช้ Health Connect เพื่อทำสิ่งต่างๆ ต่อไปนี้ได้
- เขียนข้อมูลเซสชันการออกกำลังกาย
- เขียนเส้นทางการออกกำลังกาย
- เขียนเมตริกการออกกำลังกาย เช่น อัตราการเต้นของหัวใจ ความเร็ว และระยะทาง
- อ่านข้อมูลการออกกำลังกายจากแอปอื่นๆ
คู่มือนี้อธิบายวิธีสร้างฟีเจอร์การออกกำลังกายเหล่านี้ ซึ่งครอบคลุมประเภทข้อมูล การดำเนินการในเบื้องหลัง สิทธิ์ เวิร์กโฟลว์ที่แนะนำ และแนวทางปฏิบัติแนะนำ
ภาพรวม: การสร้างเครื่องมือติดตามการออกกำลังกายที่ครอบคลุม
คุณสร้างประสบการณ์การติดตามการออกกำลังกายที่ครอบคลุมได้โดยใช้ Health Connect โดยทำตามขั้นตอนหลักต่อไปนี้
- การใช้สิทธิ์อย่างถูกต้องตามสิทธิ์ด้านสุขภาพ
- เซสชันการบันทึกโดยใช้
ExerciseSessionRecord - เขียนข้อมูลการออกกำลังกายอย่างสม่ำเสมอระหว่างเซสชัน
- จัดการการดำเนินการในเบื้องหลังอย่างเหมาะสมเพื่อยืนยันการบันทึกข้อมูลอย่างต่อเนื่อง
- การอ่านข้อมูลเซสชันเพื่อสรุปและวิเคราะห์หลังการออกกำลังกาย
เวิร์กโฟลว์นี้ช่วยให้ทำงานร่วมกับแอป Health Connect อื่นๆ ได้และยืนยันการเข้าถึงข้อมูลที่ผู้ใช้ควบคุม
ก่อนเริ่มต้น
ก่อนใช้ฟีเจอร์การออกกำลังกาย ให้ทำดังนี้
- ผสานรวม Health Connect โดยใช้ทรัพยากร Dependency ที่เหมาะสม
- สร้างอินสแตนซ์
HealthConnectClient - ยืนยันว่าแอปของคุณใช้ขั้นตอนการขอสิทธิ์รันไทม์ตามสิทธิ์ด้านสุขภาพ
- หากเวิร์กโฟลว์ใช้ GPS ให้ตั้งค่าสิทธิ์เข้าถึงตำแหน่งและบริการที่ทำงานอยู่เบื้องหน้า
แนวคิดสำคัญ
Health Connect แสดงข้อมูลการออกกำลังกายโดยใช้องค์ประกอบหลัก 2-3 อย่าง ExerciseSessionRecord ทำหน้าที่เป็นบันทึกส่วนกลางสำหรับการออกกำลังกาย โดยมีรายละเอียดต่างๆ เช่น เวลาเริ่มต้นหรือสิ้นสุด และประเภทการออกกำลังกาย ในระหว่างเซสชัน ระบบจะบันทึกข้อมูลประเภทต่างๆ เช่น HeartRateRecord หรือ SpeedRecord สำหรับกิจกรรมกลางแจ้ง ExerciseRoute จะจัดเก็บข้อมูล GPS ซึ่งลิงก์กับเซสชันที่เกี่ยวข้อง
เซสชันการออกกำลังกาย
ExerciseSessionRecord เป็นบันทึกส่วนกลางสำหรับข้อมูลการออกกำลังกาย ซึ่งแสดงถึงเซสชันการออกกำลังกาย 1 เซสชัน ระเบียนแต่ละรายการจะจัดเก็บข้อมูลต่อไปนี้
startTimeendTimeexerciseType- ข้อมูลเมตาของเซสชันที่ไม่บังคับ (ชื่อ, บันทึก)
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_RATEandroid.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>
ใช้เซสชันการออกกำลังกาย
ส่วนนี้จะอธิบายเวิร์กโฟลว์ที่แนะนำสำหรับการบันทึกข้อมูลการออกกำลังกาย
เริ่มเซสชัน
วิธีสร้างการออกกำลังกายใหม่
- สร้างรหัสเซสชันที่ไม่ซ้ำกัน: ตรวจสอบว่ารหัสนี้เสถียร หากกระบวนการของแอปถูกปิดและรีสตาร์ท คุณต้องกลับมาใช้รหัสเดิมได้เพื่อป้องกันไม่ให้เซสชันกระจัดกระจาย
- ตั้งค่า
metadata.clientRecordIdเพื่อป้องกันไม่ให้เกิดข้อมูลซ้ำระหว่างการลองซิงค์อีกครั้ง - เขียน
ExerciseSessionRecord: ระบุเวลาเริ่มต้น - เริ่มรวบรวมประเภทข้อมูลและข้อมูล 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.clientRecordIdHealth 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 และผู้ใช้ไม่ได้ตั้งค่าแอปให้อยู่ในโหมด "จำกัดแบตเตอรี่" |