查看平台架構

Health Connect 的設計宗旨是讓用戶端應用程式和 Health Connect API 能夠快速輕鬆地整合。

下圖顯示用戶端應用程式透過 SDK 層和 IPC (處理序間通訊) 與 Health Connect API 整合的程序:

每個健康功能旁邊都會顯示核取方塊
圖 1. 健康資料同步架構圖

SDK 支援

此 SDK 允許用戶端應用程式判斷 Health Connect API 是否存在於使用者的裝置上。如果不存在,系統會觸發可用性檢查,藉此判定裝置是否相容。

Health Connect SDK 支援的最低版本為 Android 8 (API 級別 26),Health Connect 應用程式則僅與 Android 9 (API 級別 28) 以上版本相容。也就是說,第三方應用程式適用於搭載 Android 8 的裝置,但只有搭載 Android 9 以上版本的裝置才能執行 Health Connect。

架構元件

1. 軟體開發套件

這個 SDK 可讓用戶端應用程式透過 IPC 與健康資料同步 APK 通訊。

2. 用戶端應用程式

如要與「健康資料同步」整合,用戶端應用程式必須將 SDK 連結至健康與健身應用程式。這麼做可提供用來與「健康資料同步」API 互動的 API 介面。

3. 健康資料同步 APK

「健康資料同步」APK 是「健康資料同步」API 的主要元素,當中包含權限管理和資料管理元件。系統會直接在使用者的裝置上提供這個 APK。

4. 權限管理

Health Connect 提供使用者介面,如果應用程式要顯示資料,可透過該介面請使用者授予權限。

此外,健康資料同步也提供現有的使用者權限清單,可讓使用者控管多個應用程式的資料存取權。

5. 資料管理

健康資料同步提供的使用者介面可列出記錄資料總覽,無論是使用者的步數、自行車速度、心率或任何其他支援的資料類型,都能一目瞭然。資料管理功能包括:

  • CRUD 作業和資料同步處理:這個平台提供資料的標準插入、更新和刪除函式。此外,用戶端應用程式也能透過這項功能同步處理資料,並產生資料變更記錄,顯示資料是否已由其他應用程式插入或刪除。

  • 基本匯總函式:用戶端可將匯總函式套用至資料,包括:

    • 平均值、最小值或最大值,例如運動期間的最低或最高心率。
    • 總和,例如一天的總步數。
    • 簡單計算測量次數,例如一週內的活動時段數。
    • 系統支援的資料類型總時間長度,例如深層睡眠時間。
  • 透過「健康資料同步」讀取資料:應用程式可以在前景運作時讀取使用者的健康與健身資料,也可以在使用者授予權限後,於背景運作時讀取資料。

    • 前景讀取:應用程式在前台時,您可以從「健康資料同步」讀取資料。如果是較長時間的作業,建議使用前台服務,避免作業中斷。
    • 背景讀取:使用者可以授予應用程式權限,允許應用程式在背景執行時讀取「健康資料同步」資料。