Khi các tính năng mới được thêm vào Health Connect, người dùng có thể không phải lúc nào cũng cập nhật phiên bản Health Connect của họ. Feature Availability API là một cách để kiểm tra xem một tính năng trong Health Connect có hoạt động trên thiết bị của người dùng hay không và quyết định hành động cần thực hiện.
Bắt đầu
API Trạng thái cung cấp tính năng có cùng phần phụ thuộc với SDK Health Connect. Để bắt đầu, hãy xác minh rằng bạn đang dùng phiên bản 1.1.0-alpha08 trở lên trong tệp build.gradle:
dependencies {
implementation("androidx.health.connect:connect-client:1.2.0-alpha06")
}
Cờ tính năng
Các cờ tính năng có sẵn cho Health Connect được liệt kê trong bảng sau. Chức năng đằng sau cờ tính năng sẽ không dùng được nếu thiết bị của người dùng không hỗ trợ tính năng đó.
| Cờ tính năng | Loại dữ liệu | Hướng dẫn liên quan |
|---|---|---|
FEATURE_ACTIVITY_INTENSITY |
Dữ liệu về cường độ hoạt động |
Bài tập thể dục |
FEATURE_EXTENDED_DEVICE_TYPES |
Loại thiết bị mở rộng |
Yêu cầu về siêu dữ liệu |
FEATURE_MATCHMAKING |
Mai mối | |
FEATURE_PERSONAL_HEALTH_RECORD |
Bệnh án |
Định dạng dữ liệu Hồ sơ y tế Ghi dữ liệu y tế Đọc dữ liệu y tế |
FEATURE_MINDFULNESS_SESSION |
Chánh niệm |
Theo dõi hoạt động chánh niệm |
FEATURE_PLANNED_EXERCISE |
Bài tập theo kế hoạch |
Bài tập thể dục Kế hoạch tập luyện |
FEATURE_READ_HEALTH_DATA_IN_BACKGROUND |
Đọc dữ liệu ở chế độ nền |
Ví dụ về việc đọc dữ liệu ở chế độ nền |
FEATURE_READ_HEALTH_DATA_HISTORY |
Đọc dữ liệu trước đây |
Đọc dữ liệu cũ hơn 30 ngày |
FEATURE_SKIN_TEMPERATURE |
Nhiệt độ trên da |
Chỉ số quan trọng Đo nhiệt độ da |
Thực hiện kiểm tra
Hàm chính để kiểm tra xem tính năng có được cung cấp hay không là getFeatureStatus().
Hàm này trả về hằng số nguyên FEATURE_STATUS_AVAILABLE hoặc FEATURE_STATUS_UNAVAILABLE:
FEATURE_READ_HEALTH_DATA_IN_BACKGROUND có hoạt động trên ứng dụng khách hay không:
if (healthConnectClient
.features
.getFeatureStatus(
HealthConnectFeatures.FEATURE_READ_HEALTH_DATA_IN_BACKGROUND
) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {
// Feature is available
} else {
// Feature isn't available
}
Để xem danh sách tất cả cờ tính năng hiện có, hãy xem trang tham khảo HealthConnectFeatures.
Xử lý trường hợp không có tính năng
Nếu một tính năng không có trên thiết bị của người dùng, thì bản cập nhật có thể bật tính năng đó. Bạn có thể cân nhắc hướng dẫn người dùng cập nhật Health Connect nếu họ không có phiên bản mới nhất được hỗ trợ trên thiết bị. Tuy nhiên, người dùng sử dụng tệp APK (trên Android 13 trở xuống) không thể dùng các tính năng của mô-đun hệ thống chỉ có trên thiết bị chạy Android 14 trở lên.
Đối với các loại thiết bị mở rộng, nếu FEATURE_EXTENDED_DEVICE_TYPES không có trên thiết bị của người dùng, thì các giá trị đó sẽ được coi là Device.TYPE_UNKNOWN. Cung cấp một phương án dự phòng hợp lý trong logic ghi và giao diện người dùng.