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ó một 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
Các ứ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).
- Chỉ số đếm đơn giản 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 cho 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ị 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
Thông thường, bạn có thể đọc dữ liệu từ Health Connect khi ứng dụng ở nền trước. Trong những trường hợp này, bạn có thể cân nhắc sử dụng một dịch vụ trên nền trước để chạy thao tác này trong trường hợp người dùng hoặc hệ thống đặt ứng dụng của bạn ở chế độ nền trong quá trình đọc.
Đố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, hãy sử dụng dịch vụ trên nền trước:
FOREGROUND_SERVICE_TYPE_HEALTH: Cho phép ứng dụng duy trì ở nền trước để thu thập dữ liệu cảm biến, chẳng hạn như một ứng dụng tập luyện tiếp tục thu thập dữ liệu ngay cả khi người dùng đặt ứng dụng ở chế độ nền.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: Một dịch vụ thuộc loại chung cho phép ứng dụng tiếp tục thu thập dữ liệu quan trọng cho các tác vụ mất ít hơn 3 phút, ngay cả khi người dùng đặt ứng dụng ở chế độ nền trước khi ứng dụng hoàn tất.
Đọ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 dữ liệu ở chế độ nền, thì người dùng có thể cấp cho ứng dụng của bạn quyền truy cập để đọc dữ liệu ở chế độ nền.