檢查功能適用的國家/地區

當 Health Connect 新增功能時，使用者不一定會更新 Health Connect 版本。您可以使用「Feature Availability API」檢查使用者的裝置是否支援 Health Connect 中的某項功能，並決定要採取哪些動作。

開始使用

Feature Availability API 與 Health Connect SDK 共用相同的依附元件。如要開始使用，請確認 Android 裝置至少搭載 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_HEALTH_DATA_BACKGROUND_READ
     ) == HealthConnectFeatures.FEATURE_STATUS_AVAILABLE) {

  // Feature is available
  ...
} else {
  // Feature is not available
  ...
}

處理功能未提供的情況

如果使用者的裝置不支援某項功能，更新可能會啟用該功能。如果使用者的裝置未安裝支援的最新版本，您可以考慮引導他們更新 Health Connect。不過，使用 APK (在 Android 13 以下版本) 的使用者無法使用僅適用於搭載 Android 14 以上版本的裝置的系統模組功能。