Trang này mô tả các chức năng chính của API Health Connect.
CRUD hoạt động trên bản ghi và đồng bộ hóa dữ liệu
Nền tảng này cung cấp các chức năng chèn, cập nhật và xoá tiêu chuẩn cho dữ liệu đã ghi. Health Connect cũng có chức năng cho phép các ứng dụng khách đồng bộ hoá dữ liệu từ Health Connect. Thao tác này sẽ tạo nhật ký thay đổi dữ liệu để cho nhà phát triển và người dùng biết liệu một số loại dữ liệu có bị các ứng dụng khác chèn hoặc xoá hay không.
Hàm tổng hợp cơ bản
Ứng dụng có thể áp dụng hàm tổng hợp trên dữ liệu cơ bản, cung cấp những thông tin sau:
- Các giá trị trung bình, tối thiểu hoặc tối đa (ví dụ: nhịp tim tối thiểu và tối đa trong một phiên hoạt động).
- Tổng số (ví dụ: tổng số bước trong một khoảng thời gian hằng ngày).
- Số đếm đơn giản về số lượng các chỉ số đo lường cơ bản (ví dụ: số phiên hoạt động trong một tuần nhất định).
- Tổng thời lượng của các loại dữ liệu được hỗ trợ (ví dụ: thời gian ngủ sâu trong tuần này hoặc tổng thời lượng của các phiên hoạt động trong hôm nay).
Kiểm tra tình trạng tương thích
Health Connect tương thích với Android SDK phiên bản 28 (Pie) trở lên. SDK cho phép ứng dụng khách xác định liệu API Health Connect có trên thiết bị chạy Android của người dùng hay không. Nếu không, Health Connect sẽ kích hoạt quá trình kiểm tra tình trạng để xác định xem thiết bị của người dùng có tương thích hay không.
Kiểm tra quyền
Health Connect yêu cầu bạn phải cho phép người dùng đọc và ghi dữ liệu sức khoẻ và thể chất của họ trên cơ sở từng ứng dụng. Nó cũng cho phép bạn xem những quyền nào người dùng cho phép hoặc từ chối.
Đọc bằng Health Connect
Đọc ở chế độ nền trước
Chỉ những ứng dụng chạy ở nền trước mới có thể đọc dữ liệu bằng Health Connect. Chúng tôi áp dụng biện pháp hạn chế này nhằm tăng cường bảo vệ quyền riêng tư của người dùng.
Đối với các tình huống mà ứng dụng của bạn có thể bị gián đoạn, chẳng hạn như hiển thị thông tin đọc trong ứng dụng, hãy đọc trực tiếp từ Health Connect đến ứng dụng khách của bạn.
Trong những tình huống mà bạn muốn ứng dụng của mình chạy liền mạch không bị gián đoạn, chẳng hạn như đọc một loạt dữ liệu từ Health Connect, sau đó ghi và tải dữ liệu lên ở một nơi khác, hãy sử dụng ForegroundService thay vì một Hoạt động có thể dễ dàng bị loại bỏ.
Đọc ở chế độ nền
Bạn có thể yêu cầu ứng dụng chạy ở chế độ nền và đọc dữ liệu từ Health Connect. Nếu bạn yêu cầu quyền Đọc ở chế độ nền, người dùng có thể cấp cho ứng dụng quyền đọc dữ liệu ở chế độ nền.