ตรวจสอบความพร้อมใช้งานของฟีเจอร์

เมื่อมีการเพิ่มฟีเจอร์ใหม่ๆ ลงใน Health Connect ผู้ใช้อาจไม่อัปเดต Health Connect เวอร์ชันของตนเสมอไป Feature Availability API เป็นวิธีตรวจสอบว่าฟีเจอร์ใน Health Connect พร้อมใช้งานในอุปกรณ์ของผู้ใช้หรือไม่ และตัดสินใจว่าจะดำเนินการใด

เริ่มต้นใช้งาน

Feature Availability API มีการอ้างอิงเดียวกันกับ Health Connect SDK หากต้องการเริ่มต้นใช้งาน ให้ตรวจสอบว่าไฟล์ 1.1.0-alpha08 มีเวอร์ชันอย่างน้อย build.gradle

dependencies {
  implementation("androidx.health.connect:connect-client:1.1.0-alpha08")
}

แฟล็กฟีเจอร์

ฟีเจอร์แฟล็กที่ใช้ได้กับ Health Connect แสดงอยู่ในตารางต่อไปนี้ ฟังก์ชันการทำงานเบื้องหลังฟีเจอร์แฟล็กจะไม่พร้อมใช้งานหากอุปกรณ์ของผู้ใช้ไม่รองรับฟีเจอร์ดังกล่าว

ทำการตรวจสอบ

ฟังก์ชันหลักในการตรวจสอบความพร้อมใช้งานของฟีเจอร์คือ getFeatureStatus() ซึ่งจะแสดงค่าคงที่จำนวนเต็ม FEATURE_STATUS_AVAILABLE หรือ FEATURE_STATUS_UNAVAILABLE

if (healthConnectClient
     .features
     .getFeatureStatus(
       HealthConnectFeatures.FEATURE_READ_HEALTH_DATA_IN_BACKGROUND
     ) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {

  // Feature is available
} else {
  // Feature isn't available
}

ดูรายการฟีเจอร์แฟล็กทั้งหมดที่ใช้ได้ในหน้าHealthConnectFeatures อ้างอิง

จัดการเมื่อฟีเจอร์ไม่พร้อมใช้งาน

หากฟีเจอร์ไม่พร้อมใช้งานในอุปกรณ์ของผู้ใช้ การอัปเดตอาจทำให้ฟีเจอร์พร้อมใช้งาน คุณอาจพิจารณานำผู้ใช้ไปอัปเดต Health Connect หากผู้ใช้ไม่มี เวอร์ชันล่าสุดที่รองรับในอุปกรณ์ อย่างไรก็ตาม ผู้ใช้ที่ใช้ APK (ใน Android 13 และต่ำกว่า) จะใช้ฟีเจอร์ของโมดูลระบบที่ใช้ได้เฉพาะในอุปกรณ์ที่ใช้ Android 14 ขึ้นไปไม่ได้

สำหรับอุปกรณ์ประเภทที่ขยาย หาก FEATURE_EXTENDED_DEVICE_TYPES ไม่พร้อมใช้งานในอุปกรณ์ของผู้ใช้ ระบบจะถือว่าค่าเหล่านั้นเป็น Device.TYPE_UNKNOWN ระบุการสำรองข้อมูลที่สมเหตุสมผลในตรรกะการเขียนและ UI