處理運動事件

健康照護服務支援 ExerciseEvents、 可在運動期間發生事件時通知應用程式，並提供相關中繼資料。

新增依附元件

使用運動事件需要最新版的 Health Services SDK。

如要為健康照護服務新增依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」一文。

接下來，在模組層級的 build.gradle 檔案中新增以下依附元件：

dependencies {
    implementation "androidx.health:health-services-client:1.1.0-alpha03"
}

dependencies {
    implementation("androidx.health:health-services-client:1.1.0-alpha03")
}

檢查功能

就像處理健康照護服務中的所有運動和資料類型一樣，請先檢查下列功能的權限： 啟動。適用對象 ExerciseEvents敬上 尤其是除了要求 ExerciseCapabilities 之外 使用 ExerciseTypeCapabilities.supportedExerciseEvents 確認特定運動支援哪些運動事件。 確認支援特定 ExerciseEvent 後， 您也應該使用 getExerciseEventCapabilityDetails。

以下範例說明如何查詢功能，以確認 系統支援 GOLF_SHOT_EVENT，然後確認 GOLF_SHOT_EVENT 支援「揮桿」類型分類

fun handleCapabilities(capabilities: ExerciseCapabilities) {
  val golfCapabilities = capabilities.typeToCapabilities[ExerciseType.GOLF]
  val golfShotEventSupported =
    golfCapabilities
      ?.supportedExerciseEvents
      ?.contains(ExerciseEventType.GOLF_SHOT_EVENT)
  val golfSwingTypeClassificationSupported =
    golfCapabilities
      ?.getExerciseEventCapabilityDetails(ExerciseEventType.GOLF_SHOT_EVENT)
      ?.isSwingTypeClassificationSupported ?: false
}

在運動中要求運動事件

若要開始運動並要求運動中的運動事件， 為運動宣告 ExerciseConfig 並為 exerciseEventType 新增欄位。

以下範例會要求 GOLF 運動中的 GOLF_SHOT_EVENT：

val config = ExerciseConfig(
  exerciseType = ExerciseType.GOLF,
  dataTypes = setOf(....),
  // ...
  exerciseEventTypes = setOf(ExerciseEventType.GOLF_SHOT_EVENT),
)

註冊運動事件更新

您可以透過現有基礎架構接收 ExerciseEvent 更新 應用程式必須接收運動更新。 以下範例說明如何整合 GolfShotEvent 更新的支援功能：

val callback = object : ExerciseUpdateCallback {
  override fun onExerciseUpdateReceived(update: ExerciseUpdate) {
      ...
  }
  // [ExerciseEvent] intended to come through with low latency and out of
  // band of onExerciseUpdateReceived()
  override fun onExerciseEventReceived(event: ExerciseEvent) {
    when (event) {
      is GolfShotEvent -> {
        if (it.swingType == GolfShotSwingType.PUTT) {
          println("Putt detected!")
        }
      }
    }
  }
}