Saat fitur baru ditambahkan ke Health Connect, pengguna mungkin tidak selalu mengupdate Health Connect versi mereka. Feature Availability API adalah cara untuk memeriksa apakah fitur di Health Connect tersedia di perangkat pengguna Anda dan memutuskan tindakan yang harus dilakukan.
Memulai
Feature Availability API memiliki dependensi yang sama dengan Health Connect SDK. Untuk memulai, pastikan setidaknya versi 1.1.0-alpha08 ada di file
build.gradle Anda:
dependencies {
implementation("androidx.health.connect:connect-client:1.1.0-alpha08")
}
Feature flags
Flag fitur yang tersedia untuk Health Connect tercantum dalam tabel berikut. Fungsi di balik tanda fitur tidak akan tersedia untuk digunakan jika perangkat pengguna tidak mendukung fitur tersebut.
| Tombol fitur | Jenis data | Panduan terkait |
|---|---|---|
FEATURE_ACTIVITY_INTENSITY |
Intensitas aktivitas | |
FEATURE_EXTENDED_DEVICE_TYPES |
Jenis perangkat yang diperluas |
Persyaratan metadata |
FEATURE_PERSONAL_HEALTH_RECORD |
Rekam medis |
Format data Catatan Medis Menulis data medis Membaca data medis |
FEATURE_MINDFULNESS_SESSION |
Mindfulness |
Melacak mindfulness |
FEATURE_PLANNED_EXERCISE |
Olahraga terencana |
Rencana pelatihan |
FEATURE_READ_HEALTH_DATA_IN_BACKGROUND |
Membaca data di latar belakang |
Contoh pembacaan di latar belakang |
FEATURE_READ_HEALTH_DATA_HISTORY |
Membaca data historis |
Membaca data yang lebih lama dari 30 hari |
FEATURE_SKIN_TEMPERATURE |
Suhu kulit |
Mengukur suhu kulit |
Lakukan pemeriksaan
Fungsi utama untuk memeriksa ketersediaan fitur adalah getFeatureStatus().
Fungsi ini menampilkan konstanta bilangan bulat FEATURE_STATUS_AVAILABLE atau
FEATURE_STATUS_UNAVAILABLE:
FEATURE_READ_HEALTH_DATA_IN_BACKGROUND di klien:
if (healthConnectClient
.features
.getFeatureStatus(
HealthConnectFeatures.FEATURE_READ_HEALTH_DATA_IN_BACKGROUND
) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {
// Feature is available
} else {
// Feature isn't available
}
Untuk mengetahui daftar semua flag fitur yang tersedia, lihat halaman referensi HealthConnectFeatures.
Menangani kurangnya ketersediaan fitur
Jika fitur tidak tersedia di perangkat pengguna, update dapat mengaktifkannya. Anda dapat mempertimbangkan untuk mengarahkan pengguna agar mengupdate Health Connect jika mereka tidak memiliki versi terbaru yang didukung di perangkat mereka. Namun, pengguna yang menggunakan APK (di Android 13 dan yang lebih rendah) tidak dapat menggunakan fitur modul sistem yang hanya tersedia di perangkat yang menjalankan Android 14 atau yang lebih tinggi.
Untuk jenis perangkat yang diperluas, jika FEATURE_EXTENDED_DEVICE_TYPES tidak tersedia di perangkat pengguna, nilai tersebut akan diperlakukan sebagai Device.TYPE_UNKNOWN. Sediakan penggantian yang wajar dalam logika penulisan dan UI Anda.