常見問題

本頁面列出部分常見問題及其解答。

問:Health Connect 是否只適用於 Android 平台?

答:是。Health Connect API 和 Health Connect 應用程式皆僅適用於 Android 平台。

如要瞭解 Wear OS 上的健康感應器資料用途,請參閱 Health Services API 說明文件

問:如何存取 Health Connect?

答:存取 Health Connect 的方式取決於裝置上執行的 Android 版本:

  • 在 Android 14 中,Health Connect 是 Android 系統的一部分。如要使用 Health Connect,請依序前往「設定」>「安全性與隱私權」>「隱私權」,然後尋找「Health Connect」
  • 在支援 Health Connect 的 Android 舊版 (包括 Android 13) 中,Health Connect 是公開提供的應用程式,您可以從 Google Play 商店下載。您可以透過下列任一方式存取應用程式:

    • 依序前往「設定」>「應用程式」,然後找出並開啟 Health Connect。
    • 使用系統匣中的快速設定,設定 Health Connect 的快速存取功能
    • 前往 Health Connect 的 Google Play 商店頁面,然後輕觸「開啟」

問:如何將健康資料從 Android 13 遷移至 Android 14?

答:只要您升級至 Android 14,系統就會自動開始從 Android 13 版的 Health Connect APK 遷移至 Android 14 版的 Health Connect 系統應用程式。

在遷移期間,Android 14 API 會遭到暫停,並顯示「遷移中」狀態。這項狀態也會在 Health Connect UI 中顯示。遷移完成後,您可以解除安裝獨立的 Health Connect APK。

詳情請參閱 Android 13 到 Android 14 的遷移指南

問:Health Connect 是否支援未安裝 Google Play 服務的 Android 手機?

答:不支援。Health Connect 有特定的相容性要求,行動裝置須搭載 Android 9 (API 28) 以上版本,並且安裝 Google Play 服務。

問:Health Connect 和 Google Fit 有何差異?

答:下表說明這兩個 API 之間的主要架構差異:

Health Connect Google Fit
以裝置為中心

Health Connect 是以裝置為中心。資料儲存在使用者的裝置上,而非與特定 Google 帳戶建立關聯。

以 Google 帳戶為中心

Google Fit 是以帳戶為中心。資料儲存在伺服器端的基礎架構上。其資料模型會與特定 Google 帳戶完全連結,而非與使用者的裝置連結。這麼做會讓伺服器成為 Google Fit 的可靠資料來源。

精細權限

使用者可透過 Health Connect 更精細地控管權限,決定其他應用程式對每種資料類型的讀取或寫入權限。

Health Connect 內建的自訂權限機制十分實用,讓 Health Connect 集中處理及修正權限的管理和分配方式。

以 OAuth 為基礎的權限

Google Fit 中的權限需要額外作業,因為這些權限是以 OAuth 驗證為基礎。OAuth 範圍可能也涵蓋了多種資料類型。

只處理少數資料

Health Connect 的資料處理與衍生的作業非常少,只有少數資料類型例外,如基礎卡路里和基礎代謝率 (BMR)。因此,開發人員可以透過 Health Connect 存取更多原始資料。

處理特定服務的資料

Google Fit 會處理更多資料,將部分資料類型轉換成其他類型的資料或進行合併。Google Fit 會處理特定服務的資料,而不是像 Health Connect 一樣提供原始資料的存取權。

問:Health Connect 是儲存在裝置端還是雲端的儲存空間?

答:Health Connect 提供裝置端儲存空間。我們的目標是打造一套系統,讓使用者能完全掌控自身資料,並控管要與哪些應用程式與服務共用資料。

問:哪些行動裝置可以使用 Health Connect 應用程式?

答:只有搭載 Android 9 (API 28) 以上版本的行動裝置才能使用 Health Connect 應用程式。這些裝置也必須安裝 Google Play 服務。

問:Jetpack 上是否有 Java SDK?最終會加入這個 SDK 嗎?

答:Health Connect SDK 僅支援 Kotlin。我們目前沒有將 Java SDK 加入 Jetpack 程式庫的計畫。不過,我們最終可能會根據開發人員的意見,支援這兩種程式設計語言。

問:Health Connect 可讀取或寫入歷來資料的範圍為何?

答:Health Connect 可讓應用程式使用 timestartTime 讀取記錄,範圍為應用程式首次成功要求權限之前最多 30 天的記錄。如果您希望應用程式在 30 天後讀取記錄,請使用 PERMISSION_READ_HEALTH_DATA_HISTORY 權限。如果您將應用程式解除安裝後再重新安裝,系統會將日期重設並標示為新的開始日期,就像您第一次使用一樣。

您提供給 Health Connect 的資料沒有限制,但目前應避免寫入大量歷來資料。同樣地,請避免寫入與未來事件相關的資料,例如預測的 MenstruationPeriodRecord

問:如果無法順利與 Health Connect 整合,該與誰聯絡?

答:如果您在整合 Health Connect 時遇到任何技術問題、困難或疑慮,請與 health-connect-support@google.com 聯絡。

我們的支援專員會盡全力迅速回覆開發人員的問題。在此同時,請參閱 Health Connect 說明文件,取得您所需要的任何指南。

問:如何宣告讀取或寫入資料類型的存取權?

答:如要讓應用程式可讀取或寫入 Health Connect 的資料類型,請使用 Play 管理中心聲明應用程式會存取這些類型