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 hàm 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 ngoài Health Connect. Thao tác này sẽ tạo một nhật ký các thay đổi về dữ liệu để cho nhà phát triển và người dùng biết liệu các ứng dụng khác có chèn hoặc xoá một số loại dữ liệu nhất định 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 cho dữ liệu cơ bản với những điều kiện 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 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 trên 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 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 xem 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 rảnh/bận để 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 đòi hỏi bạn phải yêu cầu người dùng cho phép đọc và/hoặc ghi dữ liệu sức khoẻ và thể chất của họ trên cơ sở từng ứng dụng. Trường này cũng cho phép bạn xem người dùng đã cấp hoặc từ chối những quyền nào.
Đọc bằng Health Connect
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. Health Connect sẽ thông báo và đảm bảo với người dùng rằng ứng dụng này không có quyền truy cập đọc dữ liệu trong nền, nó chỉ có thể đọc và truy cập dữ liệu ở nền trướ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, chẳng hạn như đọc một loạt dữ liệu từ Health Connect, sau đó viết và tải dữ liệu lên ở một nơi khác, hãy sử dụng ForegroundService thay vì Activity (Hoạt động) nơi nó có thể dễ dàng bị loại bỏ.