เมื่อมีการเพิ่มฟีเจอร์ใหม่ลงใน Health Connect ผู้ใช้อาจไม่ได้อัปเดต Health Connect เป็นเวอร์ชันล่าสุดเสมอไป Feature Availability API เป็นวิธีตรวจสอบว่าฟีเจอร์ใน Health Connect พร้อมใช้งานในอุปกรณ์ของผู้ใช้หรือไม่ และตัดสินใจว่าจะดำเนินการใด
เริ่มต้นใช้งาน
Feature Availability API มีทรัพยากร Dependency เดียวกันกับ SDK ของ Health Connect ในการเริ่มต้นใช้งาน ให้ตรวจสอบว่ามีเวอร์ชัน 1.1.0-alpha08 เป็นอย่างน้อยในไฟล์ build.gradle ดังนี้
dependencies {
implementation("androidx.health.connect:connect-client:1.2.0-alpha06")
}
แฟล็กฟีเจอร์
แฟล็กฟีเจอร์ที่ใช้ได้กับ Health Connect แสดงอยู่ในตารางต่อไปนี้ ฟังก์ชันการทำงานที่อยู่เบื้องหลังแฟล็กฟีเจอร์จะใช้งานไม่ได้หากอุปกรณ์ของผู้ใช้ไม่รองรับฟีเจอร์ดังกล่าว
| แฟล็กฟีเจอร์ | ประเภทข้อมูล | คู่มือที่เกี่ยวข้อง |
|---|---|---|
FEATURE_ACTIVITY_INTENSITY |
ความหนักของกิจกรรม |
การออกกำลังกาย |
FEATURE_EXTENDED_DEVICE_TYPES |
ประเภทอุปกรณ์เพิ่มเติม |
ข้อกำหนดด้านข้อมูลเมตา |
FEATURE_MATCHMAKING |
การจับคู่ผู้เล่น | |
FEATURE_PERSONAL_HEALTH_RECORD |
เวชระเบียน |
รูปแบบข้อมูลเวชระเบียน เขียนข้อมูลทางการแพทย์ อ่านข้อมูลทางการแพทย์ |
FEATURE_MINDFULNESS_SESSION |
การเจริญสติ |
ติดตามการเจริญสติ |
FEATURE_PLANNED_EXERCISE |
การออกกำลังกายที่วางแผนไว้ |
การออกกำลังกาย แผนการฝึก |
FEATURE_READ_HEALTH_DATA_IN_BACKGROUND |
อ่านข้อมูลในเบื้องหลัง |
ตัวอย่างการอ่านในเบื้องหลัง |
FEATURE_READ_HEALTH_DATA_HISTORY |
อ่านข้อมูลย้อนหลัง |
อ่านข้อมูลที่มีอายุนานกว่า 30 วัน |
FEATURE_SKIN_TEMPERATURE |
อุณหภูมิผิวหนัง |
ค่าสัญญาณชีพ วัดอุณหภูมิผิวหนัง |
ดำเนินการตรวจสอบ
ฟังก์ชันหลักในการตรวจสอบความพร้อมใช้งานของฟีเจอร์คือ getFeatureStatus()
ซึ่งจะแสดงค่าคงที่จำนวนเต็ม FEATURE_STATUS_AVAILABLE หรือ FEATURE_STATUS_UNAVAILABLE ดังนี้
FEATURE_READ_HEALTH_DATA_IN_BACKGROUND ในไคลเอ็นต์ โดยทำดังนี้
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