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

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

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

Feature Availability API ใช้ทรัพยากร Dependency เดียวกันกับ Health Connect SDK หากต้องการเริ่มต้นใช้งาน โปรดยืนยันว่าเวอร์ชัน 1.1.0-alpha08 ในไฟล์ build.gradle ของคุณเป็นอย่างน้อย

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

ดำเนินการตรวจสอบ

ฟังก์ชันหลักในการตรวจสอบความพร้อมใช้งานของฟีเจอร์คือ 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 is not available
  ...
}

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

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