Hướng dẫn này tương thích với Health Connect phiên bản 1.1.0 trở lên.
Nếu muốn xây dựng trải nghiệm tập luyện trong ứng dụng, bạn có thể dùng Health Connect để làm những việc như:
- Ghi phiên hoạt động tập thể dục
- Ghi dữ liệu về tuyến đường tập luyện
- Ghi các chỉ số về bài tập thể dục như tần số tim, tốc độ và quãng đường
- Đọc dữ liệu về hoạt động thể dục từ các ứng dụng khác
Hướng dẫn này mô tả cách xây dựng các tính năng tập luyện, bao gồm các loại dữ liệu, thực thi trong nền, quyền, quy trình làm việc được đề xuất và các phương pháp hay nhất.
Tổng quan: Xây dựng một bảng theo dõi bài tập thể dục toàn diện
Bạn có thể xây dựng trải nghiệm theo dõi bài tập thể dục toàn diện bằng Health Connect bằng cách làm theo các bước cốt lõi sau:
- Triển khai đúng các quyền dựa trên Quyền truy cập vào dữ liệu sức khoẻ.
- Ghi lại phiên bằng
ExerciseSessionRecord. - Ghi dữ liệu tập luyện một cách nhất quán trong suốt buổi tập.
- Quản lý việc thực thi trong nền đúng cách để xác minh việc thu thập dữ liệu liên tục.
- Đọc dữ liệu phiên tập thể dục để tóm tắt và phân tích sau khi tập luyện.
Quy trình này cho phép khả năng tương tác với các ứng dụng Health Connect khác và xác minh quyền truy cập dữ liệu do người dùng kiểm soát.
Trước khi bắt đầu
Trước khi triển khai các tính năng tập luyện:
- Tích hợp Health Connect bằng phần phụ thuộc thích hợp.
- Tạo một thực thể
HealthConnectClient. - Xác minh rằng ứng dụng của bạn triển khai quy trình cấp quyền khi bắt đầu chạy dựa trên Quyền truy cập vào dữ liệu sức khoẻ.
- Nếu quy trình làm việc của bạn sử dụng GPS, hãy thiết lập quyền truy cập vị trí và một dịch vụ nền trước.
Khái niệm chính
Health Connect biểu thị dữ liệu tập luyện bằng một vài thành phần cốt lõi. ExerciseSessionRecord đóng vai trò là bản ghi trung tâm cho một bài tập thể dục, chứa các thông tin chi tiết như thời gian bắt đầu hoặc kết thúc và loại bài tập. Trong một phiên, bạn có thể ghi lại nhiều loại dữ liệu như HeartRateRecord hoặc SpeedRecord. Đối với các hoạt động ngoài trời, ExerciseRoute lưu trữ dữ liệu GPS được liên kết với phiên tương ứng.
Phiên hoạt động tập thể dục
ExerciseSessionRecord là bản ghi trung tâm cho dữ liệu tập luyện, đại diện cho một
buổi tập luyện. Mỗi bản ghi lưu trữ:
startTimeendTimeexerciseType- Siêu dữ liệu không bắt buộc của phiên (tiêu đề, ghi chú)
ExerciseSessionRecord cũng có thể chứa các tuyến đường, vòng và phân đoạn tập thể dục trong dữ liệu của nó. Ngoài ra, các loại dữ liệu khác như
HeartRateRecord hoặc SpeedRecord có thể được ghi lại trong một phiên và
được liên kết với phiên đó.
Loại dữ liệu liên quan
Dữ liệu liên kết với các phiên tập thể dục được biểu thị bằng từng loại bản ghi. Sau đây là các loại phổ biến:
HeartRateRecord: Biểu thị một loạt các phép đo tần số tim.SpeedRecord: Biểu thị một loạt các phép đo tốc độ.DistanceRecord: Biểu thị khoảng cách giữa các lần đọc.TotalCaloriesBurnedRecord: Biểu thị tổng lượng calo đã đốt cháy giữa các lần đọc.ElevationGainedRecord: Thể hiện mức tăng độ cao giữa các lần đo.StepsCadenceRecord: Biểu thị nhịp độ bước chân giữa các lần đo.PowerRecord: Biểu thị công suất giữa các lần đọc, thường thấy trong các hoạt động như đạp xe.
Để xem danh sách đầy đủ các loại dữ liệu, hãy xem phần Các loại dữ liệu của Health Connect.
Tuyến đường tập thể dục
Bạn có thể liên kết một tuyến đường với các bài tập thể dục ngoài trời bằng ExerciseRoute. Tuyến đường bao gồm các đối tượng ExerciseRoute.Location tuần tự, mỗi đối tượng chứa:
- Vĩ độ và kinh độ
- Độ cao (không bắt buộc)
- Phương hướng (không bắt buộc)
- Thông tin về độ chính xác
- Dấu thời gian
Tuyến đường của phiên liên kết
ExerciseRoute chứa dữ liệu vị trí tuần tự cho một buổi tập thể dục. Dữ liệu này không được coi là một bản ghi độc lập trong Health Connect. Thay vào đó, bạn cung cấp dữ liệu ExerciseRoute khi chèn hoặc cập nhật ExerciseSessionRecord.
Điều cần cân nhắc khi phát triển ứng dụng
Ứng dụng theo dõi bài tập thể dục thường cần chạy trong thời gian dài, thường là trong nền khi màn hình tắt. Khi xây dựng các tính năng tập thể dục, bạn cần cân nhắc cách quản lý việc thực thi trong nền và yêu cầu các quyền cần thiết cho dữ liệu bài tập thể dục.
Thực thi trong nền
Ứng dụng tập thể dục thường chạy khi màn hình tắt. Khi ở trạng thái này, bạn nên sử dụng:
- Dịch vụ nền trước để lấy mẫu vị trí và cảm biến
WorkManagerđể trì hoãn việc ghi hoặc đồng bộ hoá- Chiến lược tạo lô để ghi bản ghi thông thường
Duy trì tính liên tục bằng cách giữ cho mã phiên nhất quán trong tất cả các lần ghi.
Quyền
Ứng dụng của bạn phải yêu cầu các quyền liên quan của Health Connect trước khi đọc hoặc ghi dữ liệu về hoạt động tập thể dục. Các quyền phổ biến đối với bài tập bao gồm phiên tập thể dục, tuyến đường tập thể dục và các chỉ số như tần số tim hoặc tốc độ. Điều này bao gồm:
- Phiên tập thể dục: Quyền đọc và ghi cho
ExerciseSessionRecord. - Tuyến đường tập thể dục: Quyền đọc và ghi cho
ExerciseRoute. - Tần số tim: Quyền đọc và quyền ghi đối với
HeartRateRecord. - Tốc độ: Quyền đọc và ghi cho
SpeedRecord. - Khoảng cách: Quyền đọc và ghi đối với
DistanceRecord. - Lượng calo: Quyền đọc và ghi đối với
TotalCaloriesBurnedRecord. - Mức tăng độ cao: Quyền đọc và ghi đối với
ElevationGainedRecord. - Nhịp độ bước chân: Quyền đọc và ghi đối với
StepsCadenceRecord. - Nguồn điện: Quyền đọc và ghi đối với
PowerRecord. - Các bước: Quyền đọc và ghi cho
StepsRecord.
Sau đây là ví dụ về cách yêu cầu nhiều quyền cho một buổi tập thể dục, bao gồm dữ liệu về tuyến đường, tần số tim, quãng đường, lượng calo, tốc độ và số bước:
Sau khi tạo một phiên bản ứng dụng, ứng dụng của bạn cần yêu cầu người dùng cấp quyền. Người dùng phải được phép cấp hoặc từ chối cấp quyền bất cứ lúc nào. Để thực hiện việc này, hãy tạo một tập hợp quyền cho các kiểu dữ liệu bắt buộc. Trước tiên, bạn cần khai báo các quyền trong tập hợp này ở tệp kê khai 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 để xem ứng dụng của bạn đã được cấp các quyền cần thiết chưa. Nếu chưa, hãy sử dụng createRequestPermissionResultContract để yêu cầu các quyền đó. Thao tác này sẽ hiện màn hình các quyền của 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.") } } }
Để yêu cầu quyền, hãy gọi hàm 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
Nếu bạn chỉ cần yêu cầu quyền cho một loại dữ liệu, chẳng hạn như tần số tim, thì chỉ cần đưa loại dữ liệu đó vào bộ quyền của bạn:
Quyền truy cập vào dữ liệu tần số tim được bảo vệ bằng các quyền sau:
android.permission.health.READ_HEART_RATEandroid.permission.health.WRITE_HEART_RATE
Để thêm chức năng tần số tim vào ứng dụng, hãy bắt đầu bằng cách yêu cầu quyền cho loại dữ liệu HeartRateRecord.
Dưới đây là quyền bạn cần khai báo để có thể ghi tần số tim:
<application>
<uses-permission
android:name="android.permission.health.WRITE_HEART_RATE" />
...
</application>
Để đọc dữ liệu về tần số tim, bạn cần yêu cầu các quyền sau:
<application>
<uses-permission
android:name="android.permission.health.READ_HEART_RATE" />
...
</application>
Triển khai một buổi tập thể dục
Phần này mô tả quy trình đề xuất để ghi lại dữ liệu tập thể dục.
Bắt đầu phiên
Cách tạo một bài tập mới:
- Tạo mã phiên riêng biệt: Xác minh rằng mã này ổn định. Nếu quy trình ứng dụng của bạn bị tắt và khởi động lại, bạn phải có thể tiếp tục sử dụng cùng một mã nhận dạng để ngăn các phiên bị phân mảnh.
- Đặt
metadata.clientRecordIdđể ngăn chặn các bản sao trong quá trình thử đồng bộ hoá lại. - Viết
ExerciseSessionRecord: Thêm thời gian bắt đầu. - Bắt đầu thu thập dữ liệu GPS và loại dữ liệu: Chỉ bắt đầu thu thập sau khi bản ghi phiên được khởi chạy thành công.
Ví dụ:
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))
Ghi lại lộ trình tập thể dục
Để tìm hiểu thêm về hướng dẫn đọc, hãy xem phần Đọc dữ liệu thô.
Khi ghi lại tuyến đường tập thể dục, bạn nên gộp dữ liệu của mình. Điều này có nghĩa là thay vì lưu từng điểm GPS khi điểm đó xuất hiện, bạn sẽ thu thập một nhóm điểm và lưu tất cả các điểm đó cùng một lúc trong một lệnh gọi.
Điều này rất quan trọng vì mỗi lần ứng dụng đọc hoặc ghi vào Health Connect, ứng dụng sẽ sử dụng một chút pin và sức mạnh xử lý.
Đoạn mã sau đây cho biết cách ghi lại theo lô:
// 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))
Kết thúc phiên
Sau khi ngừng thu thập dữ liệu:
- Cập nhật bản ghi: Ứng dụng của bạn cập nhật
ExerciseSessionRecordbằng mộtendTime. - Hoàn tất dữ liệu: Bạn có thể tính toán các giá trị tóm tắt (như tổng quãng đường hoặc tốc độ trung bình) và ghi các giá trị đó dưới dạng bản ghi bổ sung.
val finishedSession = session.copy(endTime = Instant.now())
healthConnectClient.updateRecords(listOf(finishedSession))
Đọc dữ liệu về bài tập thể dục
Ứng dụng có thể đọc các buổi tập thể dục và dữ liệu liên quan để tóm tắt hoạt động, cung cấp thông tin chi tiết về sức khoẻ hoặc đồng bộ hoá dữ liệu với máy chủ bên ngoài. Ví dụ: bạn có thể đọc ExerciseSessionRecord rồi truy vấn HeartRateRecord hoặc DistanceRecord xảy ra trong cùng khoảng thời gian đó.
Nếu bạn cần đồng bộ hoá dữ liệu tập luyện với máy chủ phụ trợ hoặc cập nhật kho dữ liệu của ứng dụng bằng Health Connect, hãy sử dụng ChangeLogs. Nhờ đó, bạn có thể truy xuất danh sách các bản ghi đã chèn, cập nhật hoặc xoá kể từ một thời điểm cụ thể. Cách này hiệu quả hơn so với việc theo dõi các thay đổi theo cách thủ công hoặc đọc lặp lại tất cả dữ liệu. Để biết thêm thông tin, hãy xem bài viết Đồng bộ hoá dữ liệu với Health Connect.
Đọc phiên
Để đọc các phiên tập thể dục, hãy sử dụng ReadRecordsRequest với loại là ExerciseSessionRecord. Bạn thường lọc dữ liệu này theo một phạm vi thời gian cụ thể.
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
}
}
Đọc dữ liệu về tuyến đường
Mặc dù dữ liệu ExerciseRoute được ghi dưới dạng một phần của phiên tập thể dục, nhưng dữ liệu này phải được đọc riêng. Sử dụng phương thức getExerciseRoute() với mã nhận dạng của phiên để đọc dữ liệu tuyến đường của phiên:
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
}
}
}
Đọc loại dữ liệu
Để đọc dữ liệu chi tiết cụ thể (như tần số tim) xảy ra trong một phiên, hãy sử dụng startTime và endTime của phiên để lọc yêu cầu cho loại dữ liệu đó.
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
}
}
}
Các phương pháp hay nhất
Hãy làm theo các nguyên tắc sau để cải thiện độ tin cậy của dữ liệu và trải nghiệm người dùng:
- Ghi dữ liệu thường xuyên trong quá trình theo dõi hoạt động: Đối với hoạt động theo dõi, hãy ghi dữ liệu ngay khi có hoặc sau khoảng thời gian tối đa là 15 phút.
- Sử dụng WorkManager để đồng bộ hoá trong nền: Sử dụng
WorkManagercho các lượt ghi bị trì hoãn. Hãy đặt khoảng thời gian là 15 phút để cân bằng giữa dữ liệu theo thời gian thực và hiệu suất pin. - Yêu cầu ghi theo lô: Đừng ghi riêng lẻ từng sự kiện cảm biến. Chia nhỏ yêu cầu. Health Connect xử lý tối đa 1.000 bản ghi cho mỗi yêu cầu ghi.
- Giữ cho mã phiên ổn định và duy nhất: Sử dụng giá trị nhận dạng nhất quán cho các phiên của bạn. Nếu một phiên được chỉnh sửa hoặc cập nhật, việc sử dụng cùng một mã nhận dạng sẽ giúp phiên đó không bị coi là một phiên mới, riêng biệt.
- Sử dụng tính năng phân lô cho cả loại dữ liệu và điểm lộ trình: Để giảm mức hao tổn đầu vào/đầu ra và duy trì thời lượng pin, hãy nhóm các điểm dữ liệu của bạn vào một lệnh gọi
insertRecordsduy nhất thay vì ghi riêng từng điểm. - Tránh ghi dữ liệu trùng lặp: Sử dụng mã ứng dụng khách: Khi tạo bản ghi, hãy đặt
metadata.clientRecordId. Health Connect sử dụng giá trị này để xác định các bản ghi riêng biệt. Nếu bạn cố gắng ghi một bản ghi cóclientRecordIdđã tồn tại, Health Connect sẽ bỏ qua bản ghi trùng lặp hoặc cập nhật bản ghi hiện có thay vì tạo bản ghi mới. Việc đặtmetadata.clientRecordIdlà cách hiệu quả nhất để ngăn chặn các bản sao trong quá trình thử lại đồng bộ hoá hoặc cài đặt lại ứng dụng.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" ) )
- Kiểm tra dữ liệu hiện có: Trước khi đồng bộ hoá, hãy truy vấn phạm vi thời gian để xem liệu bản ghi từ ứng dụng của bạn đã tồn tại hay chưa.
- Xác thực độ chính xác của GPS: Lọc ra các mẫu GPS có độ chính xác thấp (Ví dụ: các điểm có bán kính chính xác theo chiều ngang cao) trước khi ghi vào
ExerciseRouteđể xác minh bản đồ trông rõ ràng và chuyên nghiệp. - Đảm bảo dấu thời gian không trùng lặp: Xác minh rằng phiên mới không bắt đầu trước khi phiên trước đó kết thúc. Các phiên trùng lặp có thể gây ra xung đột trong trang tổng quan về hoạt động thể dục và các phép tính tóm tắt.
- Đưa ra lý do rõ ràng cho việc yêu cầu cấp quyền: Sử dụng quy trình
Permission.createIntentđể giải thích lý do ứng dụng của bạn cần quyền truy cập vào dữ liệu sức khoẻ, ví dụ: "Để theo dõi xu hướng huyết áp và cung cấp thông tin chi tiết". - Hỗ trợ tạm dừng và tiếp tục: Xác minh rằng ứng dụng của bạn xử lý chính xác các thao tác tạm dừng. Khi người dùng tạm dừng, hãy ngừng thu thập điểm lộ trình và các loại dữ liệu để tốc độ và thời lượng trung bình vẫn chính xác.
- Kiểm thử các phiên chạy trong thời gian dài: Theo dõi mức tiêu thụ pin trong các phiên kéo dài vài giờ để xác minh rằng khoảng thời gian phân lô và mức sử dụng cảm biến không làm tiêu hao pin của thiết bị.
- Căn chỉnh dấu thời gian với tốc độ cảm biến: Khớp dấu thời gian của bản ghi với tần suất thực tế của cảm biến để duy trì độ chân thực cao của dữ liệu.
Thử nghiệm
Để xác minh tính chính xác của dữ liệu và trải nghiệm người dùng chất lượng cao, hãy làm theo các chiến lược kiểm thử này và tham khảo tài liệu chính thức về Kiểm thử các trường hợp sử dụng hàng đầu.
Công cụ xác minh
- Hộp công cụ Health Connect: Sử dụng ứng dụng đồng hành này để kiểm tra bản ghi theo cách thủ công, xoá dữ liệu kiểm thử và mô phỏng các thay đổi đối với cơ sở dữ liệu. Đây là cách tốt nhất để xác minh rằng hồ sơ của bạn đang được lưu trữ chính xác.
- Kiểm thử đơn vị bằng
FakeHealthConnectClient: Sử dụng thư viện kiểm thử để xác minh cách ứng dụng xử lý các trường hợp hiếm gặp, chẳng hạn như thu hồi quyền hoặc ngoại lệ API mà không cần thiết bị thực.
Danh sách kiểm tra chất lượng
Kiến trúc điển hình
Quá trình triển khai bài tập thể dục thường bao gồm:
| Thành phần | Quản lý |
|---|---|
| Bộ điều khiển phiên | Trạng thái phiên Bộ hẹn giờ Logic phân lô Bộ điều khiển kiểu dữ liệu Lấy mẫu vị trí |
| Lớp kho lưu trữ (gói các thao tác của Health Connect:) | Chèn phiên Chèn loại dữ liệu Chèn điểm lộ trình Đọc thông tin tóm tắt về phiên |
| Lớp giao diện người dùng (Màn hình): | Thời lượng Loại dữ liệu trực tiếp Bản xem trước bản đồ Tính toán phân tách Dấu vết GPS trực tiếp |
Khắc phục sự cố
| Dấu hiệu | Nguyên nhân có thể gây ra lỗi | Độ phân giải |
|---|---|---|
| Tuyến đường không liên kết với phiên | Mã phiên hoặc phạm vi thời gian không khớp. | Xác minh rằng ExerciseRoute được viết với phạm vi thời gian nằm hoàn toàn trong khoảng thời gian ExerciseSessionRecord. Xác minh rằng bạn đang sử dụng mã nhận dạng nhất quán nếu tham chiếu đến phiên sau này. Xem phần Ghi lại lộ trình tập thể dục. |
| Thiếu loại dữ liệu (ví dụ: Tần số tim) | Thiếu quyền ghi hoặc bộ lọc thời gian không chính xác. | Kiểm tra để đảm bảo bạn đã yêu cầu và người dùng đã cấp quyền truy cập vào loại dữ liệu cụ thể. Xác minh rằng ReadRecordsRequest của bạn sử dụng TimeRangeFilter khớp với phiên. Xem phần Quyền. |
| Không ghi được phiên | Dấu thời gian trùng lặp. | Health Connect có thể từ chối các bản ghi trùng lặp với dữ liệu hiện có trong cùng một ứng dụng. Hãy xác thực rằng startTime của một phiên mới diễn ra sau endTime của phiên trước đó. |
| Không có dữ liệu GPS nào được ghi lại | Dịch vụ nền trước đã bị tắt hoặc không hoạt động. | Để thu thập dữ liệu khi màn hình tắt, bạn phải sử dụng dịch vụ nền trước có thuộc tính foregroundServiceType="health" hoặc vị trí. |
| Bản ghi trùng lặp xuất hiện | Thiếu clientRecordId. |
Chỉ định một clientRecordId duy nhất trong Metadata của mỗi bản ghi. Điều này cho phép Health Connect thực hiện việc loại bỏ trùng lặp nếu cùng một dữ liệu được ghi hai lần trong quá trình thử đồng bộ hoá lại. Xem Các phương pháp hay nhất. |
Các bước gỡ lỗi phổ biến
| Kiểm tra trạng thái quyền. | Luôn gọi getPermissionStatus() trước khi thực hiện thao tác đọc hoặc ghi. Người dùng có thể thu hồi quyền trong phần cài đặt hệ thống bất cứ lúc nào. |
| Xác minh chế độ thực thi. | Nếu ứng dụng của bạn không thu thập dữ liệu ở chế độ nền, hãy xác minh rằng bạn đã khai báo đúng quyền trong tệp AndroidManifest.xml và người dùng chưa đặt ứng dụng vào chế độ "Battery Restricted" (Hạn chế pin). |