本頁面說明 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 讀取特定範圍的資料,然後寫入並上傳至其他位置),請使用前景服務:
FOREGROUND_SERVICE_TYPE_HEALTH
:允許應用程式停留在前景收集感應器資料,例如健身應用程式,即使使用者將應用程式置於背景,也能繼續收集資料。FOREGROUND_SERVICE_TYPE_SHORT_SERVICE
:通用型服務,可讓應用程式繼續收集任務的重要資料,即使使用者在應用程式完成前將其置於背景也一樣。此服務適用於需時不到三分鐘的任務。
背景讀取
您可以要求應用程式在背景執行,並讀取 Health Connect 中的資料。如果您要求背景讀取權限,使用者就能授予應用程式在背景讀取資料的存取權。