SDK、用戶端應用程式和權限管理。 keywords_public:健康資料同步、架構、Android SDK、用戶端應用程式、APK、 權限管理、資料管理、CRUD、彙整
Health Connect 的設計宗旨是讓用戶端應用程式和 Health Connect API 能夠快速輕鬆地整合。
下圖顯示用戶端應用程式透過 SDK 層和 IPC (處理序間通訊) 與 Health Connect API 整合的程序:
SDK 支援
此 SDK 允許用戶端應用程式判斷 Health Android API 是否存在於使用者的裝置上。如果不存在,系統會觸發可用性檢查,藉此判定裝置是否相容。
Health Connect SDK 支援的最低版本為 Android 8 (API 級別 26),Health Connect 應用程式則僅與 Android 9 (API 級別 28) 以上版本相容。也就是說,第三方應用程式適用於搭載 Android 8 的裝置,但只有搭載 Android 9 以上版本的裝置才能執行 Health Connect。
發布管道可用性
「健康資料同步」功能會在 Alpha 版和穩定版中發布。如要進一步瞭解特定版本,請參閱「健康資料同步用戶端版本」。
Alpha 版
網站上列出的所有功能都可使用。
穩定版
所有已記錄的功能,但 擴充裝置類型除外。
架構元件
本節將詳細說明構成「健康資料同步」架構的主要元件,包括 SDK、用戶端應用程式、「健康資料同步」APK,以及權限和資料管理功能。
1. 軟體開發套件
這個 SDK 可讓用戶端應用程式透過 IPC 與健康資料同步 APK 通訊。
2. 用戶端應用程式
如要與「健康資料同步」整合,用戶端應用程式必須將 SDK 連結至健康與健身應用程式。這麼做可提供用來與「健康資料同步」API 互動的 API 介面。
3. 健康資料同步 APK
「健康資料同步」APK 是「健康資料同步」API 的主要元素,當中包含權限管理和資料管理元件。系統會直接在使用者的裝置上提供這個 APK。
4. 權限管理
Health Connect 提供使用者介面,如果應用程式要顯示資料,可透過該介面請使用者授予權限。
此外,健康資料同步也提供現有的使用者權限清單,可讓使用者控管多個應用程式的資料存取權。
5. 資料管理
健康資料同步提供的使用者介面可列出記錄資料總覽,無論是使用者的步數、自行車速度、心率或任何其他支援的資料類型,都能一目瞭然。資料管理功能包括:
CRUD 作業和資料同步處理:這個平台提供資料的標準插入、更新和刪除函式。此外,用戶端應用程式也能透過這項功能同步處理資料,並產生資料變更記錄,顯示資料是否已由其他應用程式插入或刪除。
基本匯總函式:用戶端可以對資料套用匯總函式,包括:
- 平均值、最小值或最大值,例如活動時段的最低或最高心率。
- 總和,例如一天的總步數。
- 測量次數,例如一週內的活動時段數。
- 系統支援的資料類型總時間長度,例如深層睡眠時間。
透過「健康資料同步」讀取資料:應用程式可以在前景運作時讀取使用者的健康與健身資料,也可以在使用者授予權限後,於背景運作時讀取資料。
- 前景讀取:應用程式在前台時,可以從「健康資料同步」讀取資料。如果是較長時間的作業,建議使用前景服務,避免作業中斷。
- 背景讀取:使用者可以授予應用程式權限,允許應用程式在背景執行時讀取「健康資料同步」中的資料。