如何快速開發一個健康助手,實時守護用戶健康

  • 2022 年 8 月 19 日
  • 筆記

隨著人們生活水平的提高,大家對健康越來越重視和關注,用戶在使用一些健康App時不僅想知道身高體重等基礎情況,還想了解一些關於心率、血氧等日常數據,方便隨時關注自身健康狀況。這時候就需要App每天關注健康數據並且記錄下來,如日常飲食、睡眠習慣,心率、血壓血糖變化和運動數據等,並且建立一份個人健康檔案,查看一段時間內如一周、一個月的健康數據變化趨勢,第一時間關注異常數據,從而及時就醫或者調整生活習慣。如此一來,用戶便可以更好地掌控自己的健康狀況,醫生也可以更準確地診斷。

那麼對於健康App來說,如何實現以上功能呢?華為運動健康服務(Health Kit)為開發者開放基礎能力。通過集成Health Kit基礎能力,您可以快速為App構建基礎功能,如讀取、插入、刪除、更新一日或多日健康記錄,為用戶帶來優質體驗。

開發者應用通過接入Health Kit基礎能力服務,在用戶授權後,即可獲取華為運動健康App上用戶的雲側健康數據,並在應用上展示給用戶。

效果示例

此Demo在運動健康服務基礎能力服務示例程式碼基礎上進行修改,感興趣的開發者可自行下載體驗優化。

開發準備

  1. 註冊帳號及申請帳號服務:因Health Kit服務需要用到帳號服務的能力,需先申請華為帳號服務後才能申請Health Kit服務。

  2. 申請Health Kit服務:申請產品所需的數據讀寫許可權。在開發服務中找到並申請Health Kit服務。勾選產品需要申請的數據許可權,這裡我們需要申請的身高、體重屬於非受限數據,提交申請後會快速審核通過,心率、血壓、血糖、血氧飽和度屬於受限數據,需要經過人工審核。

  1. 集成HMS Core SDK:在開發應用前,需要將Health Kit擴展服務能力的SDK集成到開發環境中。

使用Android Studio打開項目工程,找到並打開項目工程根路徑下的build.gradle文件。在「allprojects > repositories」和「buildscript > repositories」裡面增加SDK的maven倉地址。

maven {url '//developer.huawei.com/repo/'}

打開app下應用級的build.gradle文件,在「dependencies」中添加如下編譯依賴。

implementation 'com.huawei.hms:health:{version}'

重新打開修改完的build.gradle文件,右上方出現Sync Now鏈接。點擊「Sync Now」等待同步完成。

  1. 配置混淆腳本:編譯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.**{*;}
  1. 導入證書指紋、修改包名、配置JDK編譯版本
    根據「創建應用的Keystore文件」指南,生成Keystore文件並導入到應用中,導入後,打開應用級的「build.gradle」文件,可以看到導入的結果。

修改應用包名,應用包名應與「申請帳號服務」中填寫的包名保持一致。
打開App下應用級根目錄的「build.gradle」文件,在「android」中新增compileOptions配置,配置格式如下:

compileOptions {
    sourceCompatibility = '1.8'
    targetCompatibility = '1.8'
}

主要實現程式碼

  1. 拉起登錄頁面進行登錄授權。
/**
 * 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);
}
  1. 調用 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對象包含具體的數據類型,和數據的值,進行解析即可拿到對應的數據。

了解更多詳情>>

訪問華為開發者聯盟官網
獲取開發指導文檔
華為移動服務開源倉庫地址:GitHubGitee

關注我們,第一時間了解 HMS Core 最新技術資訊~