遷移指南

Google 旗下有多項健康產品與服務,包括 Health Connect。Google Fit API 已淘汰,並將在 2025 年 6 月 30 日終止服務。下列指南將說明從各個 Google Fit Android API 遷移至哪個 API 或平台。

從 Fit Android API 遷移至 Health Connect API

您必須完成 3 個重要步驟,才能遷移至 Health Connect API。

步驟 1:整合

整合的第一步是在應用程式中加入 Health Connect。包括:

  • 按照這些入門指南整合 Health Connect。
  • 在應用程式資訊清單中宣告資料類型和存取模式。
  • 必須取得使用者的許可,才能存取 Health Connect。
  • 根據您的特定用途或工作流程讀取/寫入資料。

步驟 2:遷移

建議同時啟用 Google Fit Android API 和 Health Connect API 整合功能,在使用者從某個平台遷移至另一個平台時。雖然 Google Fit Android API 已淘汰,但我們預計在 2025 年 6 月 30 日以前停用 API。這是為了讓使用者有足夠時間切換至 Health Connect 並繼續提供服務。

步驟 3:清除

請按照下列步驟移除 Google Fit SDK:

  1. 移除與 Google Fit Android API 相關聯的程式碼。
  2. 移除 Google Play 服務依附元件

感應器 API

感應器 API 可讓您即時在應用程式中讀取原始感應器資料。感應器 API 會執行下列作業:

  • 列出裝置和隨附裝置上可用的資料來源。
  • 註冊監聽器,以便接收原始感應器資料。
  • 取消註冊監聽器,使其不再接收原始感應器資料。

請從感應器 API 遷移至下列 API 或平台:

電話 Wear

使用 SensorManager、FusedLocationProvider

使用健康服務

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    或使用 SensorManager、FusedLocationProvider

工作階段 API

工作階段是指使用者進行健身活動的時段。

工作階段 API 讓您的應用程式能在健身商店中建立工作階段。

從工作階段 API 遷移至下列 API 或平台:

電話 Wear

開始/停止:不適用。應用程式應於內部追蹤進行中的工作階段狀態。

讀取/寫入:使用 Health Connect。

開始/停止:使用健康服務 (ExerciseClient)

讀取/寫入:透過行動應用程式使用 Health Connect。

對於特定的工作流程,我們建議採取下列做法:

  • 插入工作階段:開發人員應使用 Health Connect,並視情況插入 ActivitySession 記錄或 SleepSession 記錄。
  • 錄製 API

    錄製 API 可讓應用程式透過建立訂閱的方式,自動以高效的方式儲存感應器資料。訂閱與 Android 應用程式相關聯,內含健身資料類型或特定資料來源。

    從錄製 API 遷移至下列 API 或平台:

    電話 Wear

    請按照下列步驟從錄製 API 遷移資料:

    1. 使用 SensorManager 實作資料擷取。
    2. 將擷取的資料寫入 Health Connect。
    3. 視需要在前景服務中結合步驟 ab,例如您需要在不與應用程式本身互動的情況下繼續記錄資料。

    使用健康服務

    • PassiveMonitoringClient
    • ExerciseClient

      請參閱 Health Services 說明文件,進一步瞭解 PassiveMonitoringClient 與 ExerciseClient 之間的差異。

    History API

    記錄 API 可讓應用程式在健身商店中執行大量作業,包括讀取、插入、更新及刪除歷來健康與保健資料。

    從 History API 遷移至下列 API 或平台:

    電話 Wear

    使用 Health Connect

    使用行動應用程式中的 Health Connect,不要使用穿戴式裝置。

    目標 API

    目標是指使用者在 Google Fit 應用程式中自行設定的目標。有助於使用者每天保持活躍。使用者可以在設定檔中調整每天要達成的步數和心肺強化分數。Fit 平台使用 目標 API 記錄目標並追蹤每日活動情況。

    電話 Wear
    沒有可用的替代 API。 沒有可用的替代 API。

    BLE API

    您的應用程式可以使用 BLE API 尋找可用的藍牙低功耗 (BLE) 裝置,並將感應器資料插入 Google Fit 平台。

    從 BLE API 遷移至下列 API 或平台:

    電話 Wear
    直接使用 Android Bluetooth API。 直接使用 Android Bluetooth API。