查看 Health Connect 功能

本頁面說明 Health Connect API 的主要功能。

針對記錄和資料同步處理的 CRUD 作業

這個平台提供針對記錄資料的標準插入、更新和刪除函式。Health Connect 也提供相關功能,讓用戶端應用程式能同步處理 Health Connect 以外的資料。這項作業會產生資料變更記錄,向開發人員和使用者指出是否已由其他應用程式插入或刪除特定資料類型。

基本匯總函式

用戶端可將匯總函式套用至基礎資料,提供下列項目:

  • 平均、最小或最大值 (例如活動時段的最低和最高心率)。
  • 總和 (例如每日間隔的總步數)。
  • 基礎測量次數的簡單計數 (例如某一週的活動時段數)。
  • 針對系統支援的資料類型提供總時間長度 (例如本週的深度睡眠時間,或是今天的活動時段總時間長度)。

可用性檢查

Health Connect 與 Android SDK 28 (Pie) 以上版本相容。此 SDK 允許用戶端應用程式判斷 Health Connect API 是否存在於使用者的 Android 裝置上。如果不存在,Health Connect 會觸發可用性檢查,藉此判定使用者的裝置是否相容。

權限檢查

Health Connect 規定您必須要求使用者針對個別應用程式,逐一授予他們健康與健身資料的讀取和寫入權限。此外,Health Connect 也能讓您查看使用者已授予或拒絕的權限。

使用 Health Connect 進行讀取

前景讀取

只有具備在前景執行的應用程式才能透過 Health Connect 讀取資料。這項限制旨在進一步強化使用者隱私。

如果應用程式可能會遇到中斷 (例如在應用程式中顯示讀取),請直接從 Health Connect 讀取至用戶端應用程式。

在您可能希望應用程式順利執行的情況下 (例如,從 Health Connect 讀取特定範圍的資料,然後寫入並上傳至其他位置) 時,您可以使用 前景服務,而非可輕鬆關閉的 Activity。

背景讀取

您可以要求應用程式在背景執行,並讀取 Health Connect 中的資料。如果您要求背景讀取權限,使用者就能授予應用程式在背景讀取資料的存取權。