随着人們生活水準的提高,大家對健康越來越重視和關注,使用者在使用一些健康App時不僅想知道身高體重等基礎情況,還想了解一些關于心率、血氧等日常資料,友善随時關注自身健康狀況。這時候就需要App每天關注健康資料并且記錄下來,如日常飲食、睡眠習慣,心率、血壓血糖變化和運動資料等,并且建立一份個人健康檔案,檢視一段時間内如一周、一個月的健康資料變化趨勢,第一時間關注異常資料,進而及時就醫或者調整生活習慣。如此一來,使用者便可以更好地掌控自己的健康狀況,醫生也可以更準确地診斷。
那麼對于健康App來說,如何實作以上功能呢?華為運動健康服務(Health Kit)為開發者開放基礎能力。通過內建Health Kit基礎能力,您可以快速為App建構基礎功能,如讀取、插入、删除、更新一日或多日健康記錄,為使用者帶來優質體驗。
開發者應用通過接入Health Kit基礎能力服務,在使用者授權後,即可擷取華為運動健康App上使用者的雲側健康資料,并在應用上展示給使用者。
效果示例

此Demo在運動健康服務基礎能力服務示例代碼基礎上進行修改,感興趣的開發者可自行下載下傳體驗優化。
開發準備
- 注冊帳号及申請帳号服務:因Health Kit服務需要用到帳号服務的能力,需先申請華為帳号服務後才能申請Health Kit服務。
- 申請Health Kit服務:申請産品所需的資料讀寫權限。在開發服務中找到并申請Health Kit服務。勾選産品需要申請的資料權限,這裡我們需要申請的身高、體重屬于非受限資料,送出申請後會快速稽核通過,心率、血壓、血糖、血氧飽和度屬于受限資料,需要經過人工稽核。
- 內建HMS Core SDK:在開發應用前,需要将Health Kit擴充服務能力的SDK內建到開發環境中。
使用Android Studio打開項目工程,找到并打開項目工程根路徑下的build.gradle檔案。在“allprojects > repositories”和“buildscript > repositories”裡面增加SDK的maven倉位址。
maven {url 'https://developer.huawei.com/repo/'}
打開app下應用級的build.gradle檔案,在“dependencies”中添加如下編譯依賴。
implementation 'com.huawei.hms:health:{version}'
重新打開修改完的build.gradle檔案,右上方出現Sync Now連結。點選“Sync Now”等待同步完成。
- 配置混淆腳本:編譯APK前需要配置混淆配置檔案,避免混淆HMS Core SDK導緻功能異常。
在應用級根目錄下打開混淆配置檔案“proguard-rules.pro”,加入排除HMS Core SDK的混淆配置腳本。
-ignorewarnings
-keepattributes *Annotation*
-keepattributes Exceptions
-keepattributes InnerClasses
-keepattributes Signature
-keepattributes SourceFile,LineNumberTable
-keep class com.huawei.hianalytics.**{*;}
-keep class com.huawei.updatesdk.**{*;}
-keep class com.huawei.hms.**{*;}
-
導入證書指紋、修改包名、配置JDK編譯版本:
根據“建立應用的Keystore檔案”指南,生成Keystore檔案并導入到應用中,導入後,打開應用級的“build.gradle”檔案,可以看到導入的結果。
修改應用包名,應用包名應與“申請帳号服務”中填寫的包名保持一緻。
打開App下應用級根目錄的“build.gradle”檔案,在“android”中新增compileOptions配置,配置格式如下:
compileOptions {
sourceCompatibility = '1.8'
targetCompatibility = '1.8'
}
主要實作代碼
- 拉起登入頁面進行登入授權。
/**
* Add scopes to apply for and obtains the authorization process Intent.
*/
private void requestAuth() {
// Add scopes to apply for. The following only shows an example.
// Developers need to add scopes according to their specific needs.
String[] allScopes = Scopes.getAllScopes();
// Obtains the authorization process Intent.
// True indicates that the health app authorization process is enabled. False indicates disabled.
Intent intent = mSettingController.requestAuthorizationIntent(allScopes, true);
// The authorization process page is displayed.
startActivityForResult(intent, REQUEST_AUTH);
}
- 調用 com.huawei.hms.hihealth. DataController類的readLatestData() 接口,讀取健康相關的最新資料。包括使用者的身高、體重、心率、血壓、血糖和血氧。
/**
* read the latest data basing on data type
*
* @param view (indicating a UI object)
*/
public void readLatestData(View view) {
// 1. Use the specified data type (DT_INSTANTANEOUS_HEIGHT) to call the data controller to query
// the latest data of this data type.
List<DataType> dataTypes = new ArrayList<>();
dataTypes.add(DataType.DT_INSTANTANEOUS_HEIGHT);
dataTypes.add(DataType.DT_INSTANTANEOUS_BODY_WEIGHT);
dataTypes.add(DataType.DT_INSTANTANEOUS_HEART_RATE);
dataTypes.add(DataType.DT_INSTANTANEOUS_STRESS);
dataTypes.add(HealthDataTypes.DT_INSTANTANEOUS_BLOOD_PRESSURE);
dataTypes.add(HealthDataTypes.DT_INSTANTANEOUS_BLOOD_GLUCOSE);
dataTypes.add(HealthDataTypes.DT_INSTANTANEOUS_SPO2);
Task<Map<DataType, SamplePoint>> readLatestDatas = dataController.readLatestData(dataTypes);
// 2. Calling the data controller to query the latest data is an asynchronous operation.
// Therefore, a listener needs to be registered to monitor whether the data query is successful or not.
readLatestDatas.addOnSuccessListener(new OnSuccessListener<Map<DataType, SamplePoint>>() {
@Override
public void onSuccess(Map<DataType, SamplePoint> samplePointMap) {
logger("Success read latest data from HMS core");
if (samplePointMap != null) {
for (DataType dataType : dataTypes) {
if (samplePointMap.containsKey(dataType)) {
showSamplePoint(samplePointMap.get(dataType));
handleData(dataType);
} else {
logger("The DataType " + dataType.getName() + " has no latest data");
}
}
}
}
});
readLatestDatas.addOnFailureListener(new OnFailureListener() {
@Override
public void onFailure(Exception e) {
String errorCode = e.getMessage();
String errorMsg = HiHealthStatusCodes.getStatusCodeMessage(Integer.parseInt(errorCode));
logger(errorCode + ": " + errorMsg);
}
});
}
其中的DataType對象包含具體的資料類型,和資料的值,進行解析即可拿到對應的資料。