Xem xét chức năng của Health Connect
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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
Thông thường, bạn có thể đọc dữ liệu của Health Connect khi ứng dụng đang ở nền trước. Trong những trường hợp này, bạn có thể cân nhắc sử dụng 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 khi thao tác đọ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 trường hợp 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 vẫn ở chế độ nền trước để thu thập dữ liệu cảm biến, chẳng hạn như ứng dụng tập thể dục tiếp tục thu thập dữ liệu ngay cả khi người dùng chuyển ứng dụng sang chế độ nền.
FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: Một dịch vụ 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 chưa đến 3 phút, ngay cả khi người dùng đặt ứng dụng ở chế độ nền trước khi 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 ở chế độ nền, người dùng có thể cấp cho ứng dụng quyền đọc dữ liệu ở chế độ nền.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],null,["# Review Health Connect functionality\n\nThis page describes the main functions of the Health Connect API.\n\nCRUD operations on record and data synchronization\n--------------------------------------------------\n\nThe platform provides standard insert, update, and delete functions for recorded\ndata. Health Connect also includes functionality that allows client apps to\nsynchronize data out of Health Connect. This produces a log of data changes\nthat shows the developer and user whether certain data types have been\ninserted or deleted by other apps.\n\nBasic aggregation functions\n---------------------------\n\nClients can apply an aggregation function over underlying data, providing the\nfollowing:\n\n- The **average, minimum or maximum** values (for example, the minimum and maximum heart rate during an activity session).\n- The **sum total** (for example, the total step count in a daily interval).\n- A **simple count** of the number of underlying measurements (for example, the number of activity sessions in a given week).\n- The **total duration** on supported data types (for example, time spent in deep sleep this week, or total duration of activity sessions today).\n\nAvailability checks\n-------------------\n\nHealth Connect is compatible with Android SDK version 28 (Pie) and higher.\nThe SDK allows client apps to determine whether the Health Connect API is on\nthe user's Android-powered device. If it isn't, Health Connect triggers an\navailability check to determine whether the user's device is compatible.\n\nPermission checks\n-----------------\n\nHealth Connect requires you to request the user's permission to read and\nwrite their health and fitness data on a per-app basis. It also lets you\nsee what permissions have already been granted or denied by the user.\n\nReading with Health Connect\n---------------------------\n\n### Foreground reading\n\nYou can normally read data from Health Connect when your app is\nin the foreground. In these cases, you may consider using a foreground service\nto run this operation in case the user or system places your app\nin the background during a read operation.\n\nFor situations in which your app may expect an interruption, such as displaying\na reading in your application, read directly from Health Connect to your client\napplication.\n\nFor situations in which you prefer your app to run without\ninterruptions, use a\n[foreground service](/develop/background-work/services/fgs):\n\n- [`FOREGROUND_SERVICE_TYPE_HEALTH`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_HEALTH): Allows app to remain in\n the foreground to collect sensor data, such as a workout app that continues\n to collect data even when the user puts the app in the background.\n\n- [`FOREGROUND_SERVICE_TYPE_SHORT_SERVICE`](/reference/android/content/pm/ServiceInfo#FOREGROUND_SERVICE_TYPE_SHORT_SERVICE): A generic-type\n service that allows an app to continue to collect critical data for\n tasks that take less than three minutes,\n even if the user places the app in the background before it completes.\n\n### Background reading\n\nYou can request that your application run in the background and read data from\nHealth Connect. If you request the\n[Background Read](/health-and-fitness/guides/health-connect/develop/read-data#background-read-example)\npermission, your user can grant your app access to read data in the background."]]
