遷移指南

Google 旗下有多項健康產品與服務,包括 Health Connect。Google Fit Android API 已淘汰,將於 2024 年底停止支援,屆時將關閉服務。下列指南將說明從各個 Google Fit Android API 遷移至哪個 API 或平台。

感應器 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

    History 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。

    從 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 整合功能,在使用者從某個平台遷移至另一個平台時。雖然我們已淘汰 Fit Android API,但預計在 2024 年底前停用 API。這是為了讓使用者有足夠時間切換至 Health Connect 並繼續提供服務。

    步驟 3:清除

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

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

    Fit Android API 淘汰的時間應視自己的分析和評估而定。在 2024 年底前,您可以繼續與 Fit Android API 整合。