1. 介绍
HUAWEI Research开放研究APP框架,提供极简接入、智能终端数据采集、大数据分析、闭环干预等一站式服务,帮助合作伙伴提升研究效率,快速孵化创新应用和解决方案。
开发者通过在APP中集成Research Kit接入HUAWEI Research平台,为此,开发者需要:
- 在开发者联盟注册企业级开发者帐号,并在开发者管理台上创建应用以及开通账号服务;
- 在开发者联盟"智慧生活"中,申请开通HUAWEI Research服务;
- 使用Android Studio IDE创建工程,并配置接入HUAWEI Research依赖的SDK;
- 根据HUAWEI Research开发指南,实现研究框架的API调用以及调试。
您将开发什么
在本次Codelab中,您只需要在下载参考工程后,根据本文档完成相应的代码片段补充,即可实现房颤主动测量的功能开发。该功能会在UI上呈现数据采集信号量检测结果、PPG实时波形、房颤测量图形化结果等。
您将会学到什么
- 如何使用HUAWEI Research的开放能力;
- 如何连接穿戴设备;
- 如何实现房颤主动测量;
- 如何获取房颤测量结果数据及研究数据如何上云存储。
2. 您需要什么
硬件要求
- 开发计算机(台式机或笔记本电脑),运行Windows 7及以上版本的操作系统;
- 华为手机(带USB线),用于真机调试开发;
- 华为手表GT2,用于采集传感器及运动健康统计数据。
软件要求
- JDK 1.8及以上;
- Android API 23及以上;
- 华为手机EMUI 8.1及以上,手机上装有HMS Core(APK)4.0.2.300及以上版本;
- 非华为手机不支持。
需要的知识点
- 掌握Java基本语法;
- 了解Android Studio基本使用(包括:编译、生成APK、安装APK、调试)。
3. 能力接入准备
集成HUAWEI Research Kit,需要完成以下准备工作:
- 创建AGC应用;
- 申请开通HUAWEI Research服务;
- 创建Android Studio工程
- 生成签名证书
- 生成签名证书指纹
- 配置签名证书指纹
- 添加应用包名并保存配置文件
- 配置 HUAWEI Research Kit
- 在Android Studio配置签名文件
具体操作,请按照《HUAWEI Research研究项目申请指导》中详细说明来完成。
4. 集成SDK
开发环境
Android Studio开发环境, V4.0版本及以上
导入HUAWEI Research 依赖
- 打开app下应用级的build.gradle文件

- 将HUAWEI Research 依赖包导入至app下libs文件夹中

- 在app下应用级的build.gradle中添加如下依赖
implementation fileTree(dir: "libs", include: ["*.jar",'*.aar']) implementation 'androidx.appcompat:appcompat:1.1.0' implementation 'androidx.constraintlayout:constraintlayout:1.1.3' testImplementation 'junit:junit:4.12' androidTestImplementation 'androidx.test.ext:junit:1.1.1' androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0' implementation 'com.huawei.hms:hwid:4.0.4.300' implementation('com.google.guava:guava:28.2-android') { exclude group: 'com.google.code.findbugs', module: 'jsr305' } implementation 'org.codehaus.mojo:animal-sniffer-annotations:1.17' implementation 'com.google.errorprone:error_prone_annotations:2.3.3' implementation 'com.squareup.okhttp3:okhttp:3.14.4' implementation 'com.squareup.okio:okio:1.17.2' implementation 'com.squareup.okhttp3:logging-interceptor:4.4.1' implementation 'io.reactivex.rxjava2:rxjava:2.1.13' implementation ('io.reactivex.rxjava2:rxandroid:2.1.1') { exclude group: 'io.reactivex.rxjava2', module: 'rxjava' } implementation 'com.squareup.retrofit2:retrofit:2.8.1' implementation 'com.squareup.retrofit2:converter-gson:2.8.0' implementation 'com.squareup.retrofit2:converter-scalars:2.5.0' implementation 'com.squareup.retrofit2:adapter-rxjava2:2.5.0' implementation 'com.squareup.retrofit2:retrofit-converters:2.5.0' implementation 'com.android.support:support-annotations:28.0.0' implementation 'joda-time:joda-time:2.10.3' testImplementation 'junit:junit:4.12' implementation 'com.alibaba:fastjson:1.2.70' implementation 'com.google.code.gson:gson:2.8.5' implementation 'com.jakewharton:butterknife:10.2.2' annotationProcessor 'com.jakewharton:butterknife-compiler:10.2.2' implementation 'pub.devrel:easypermissions:1.0.1' implementation 'com.google.zxing:core:3.4.0' implementation 'de.hdodenhof:circleimageview:2.0.0' implementation 'pub.devrel:easypermissions:1.0.1' implementation 'com.android.support:multidex:1.0.3' implementation 'org.aspectj:aspectjrt:1.9.5' implementation 'com.airbnb.android:lottie:2.7.0' implementation 'androidx.gridlayout:gridlayout:1.0.0' implementation 'androidx.recyclerview:recyclerview:1.0.0' implementation 'com.jamesmurty.utils:java-xmlbuilder:1.1' implementation 'com.fasterxml.jackson.core:jackson-core:2.10.0' implementation 'com.fasterxml.jackson.core:jackson-databind:2.10.0' implementation 'com.fasterxml.jackson.core:jackson-annotations:2.10.0' - 重新打开修改完的build.gradle文件,右上方出现Sync Now链接。点击"Sync Now"等待同步完成

5. Demo开发
所有示例代码开发均在MainActivity.java中完成,整个工程代码结构如下,:
1.运行初始工程(下载原始框架代码)
- 解压初始demo工程(如:解压至D:\codelab\healthstudy下)
- 使用Android Studio打开healthstudy工程,编译生成APK文件,安装至手机查看运行结果。App运行后用户界面显示如下所示:

2.添加申请授权、用户协议及隐私申明代码
在MainActivity.java类onCreate方法中添加如下代码片段:
HiResearchPermissionTask permissionActiveTask = new HiResearchPermissionTask(this);
permissionActiveTask.registerTaskListener(new HiResearchPermissionTaskListener() {
@Override
public void onPermissionsDenied() {
ActivityManager.getAppManager().exitApp();
}
});
HiResearchConsentTask consentActiveTask = new HiResearchConsentTask(this, disposable);
consentActiveTask.registerTaskListener(new HiResearchConsentTaskListener() {
@Override
public void onAgree() {
btnLogin.setEnabled(true);
}
@Override
public void onDisAgree() {
ActivityManager.getAppManager().exitApp();
}
});
permissionActiveTask.registerErrorListener(this);
permissionActiveTask.setNext(consentActiveTask);
permissionActiveTask.start();
3.添加登录代码
在MainActivity.java类onLoginClicked方法中添加如下代码片段:
HiResearchLoginTask loginActiveTask = new HiResearchLoginTask(this, disposable);
loginActiveTask.registerErrorListener(this);
loginActiveTask.registerTaskListener(new HiResearchLoginTaskListener() {
@Override
public void onLoginSuccess(String projectCode, AuthHuaweiId authHuaweiId, UserSessionInfo hiResearchUserSessionInfo) {
btnJoin.setEnabled(true);
}
@Override
public void onLoginFailure(String projectCode, HttpMessageDataResponse message) {
toast("login failed:" + message.toString());
}
});
loginActiveTask.start();
4.添加加入研究项目代码
在MainActivity.java类onJoinClicked方法中添加如下代码片段:
HiResearchJoinStudyTask joinStudyActiveTask = new HiResearchJoinStudyTask(this, disposable);
joinStudyActiveTask.registerErrorListener(this);
joinStudyActiveTask.registerTaskListener(new HiResearchJoinStudyTaskListener() {
@Override
public void onJoinSuccess(String projectCode, JoinInfo data) {
btnDevice.setEnabled(true);
}
@Override
public void onJoinFailure(String projectCode, HttpMessageDataResponse message) {
toast("join study failed:" + message.toString());
}
});
joinStudyActiveTask.start();
5.添加设备连接代码
在MainActivity.java类onDeviceClicked方法中添加如下代码片段:
HiResearchConnectDeviceTask deviceActiveTask = new HiResearchConnectDeviceTask(this, disposable);
deviceActiveTask.registerErrorListener(this);
deviceActiveTask.registerTaskListener(new HiResearchDeviceTaskListener() {
@Override
public void onDeviceStatusChanged(SensorProDeviceInfo deviceInfo) {
if (deviceInfo.getDeviceConnectState() == 2) {
btnMeasure.setEnabled(true);
}
}
});
deviceActiveTask.start();
6.添加房颤主动测量代码
- 在
MainActivity类onMeasureClicked方法中添加如下代码片段:HiResearchAtrialTask atrialActiveTask = new HiResearchAtrialTask(this, disposable); atrialActiveTask.registerErrorListener(this); atrialActiveTask.registerTaskListener(this); atrialActiveTask.start();
7.获取房颤测量结果及上云代码
- 在
MainActivity.java类onAtrialMeasureResult方法中添加如下代码片段:String userNo = "您的用户编号"; AtrialFibrillationMeasureResultMetadata measureResultMetadata = new AtrialFibrillationMeasureResultMetadata(userNo, atrialMeasureResult); BridgeDataProvider bridgeDataProvider = BridgeManager2.getFirstInstance().getBridgeDataProvider(); disposable.add( bridgeDataProvider .upload(measureResultMetadata, null) .subscribe(resp -> { if (resp.getSuccess()) { toast("The result was uploaded successfully!"); } else { toast("Result upload failed:" + resp.toString()); } }, err -> { toast("Result upload failed:" + err.toString()); }));
6. 体验运行效果
- 编译生成APK,将APK安装至华为手机;
- 打开刚安装的健康研究App;
- 允许健康研究获相应Android授权


- 签署《用户协议》及《隐私申明》

- 点击"登录"按钮登录,首次运行会弹出登录框,点击授权并登录
- 点击"加入研究项目"按钮加入健康研究
- 点击"设备连接"按钮连接手表(GT2),搜索设备框中按设备名称选择指定对应手表



- 点击"房颤主动测量"按钮开启房颤测量

|
|
|
7. 恭喜你
祝贺您,您已经成功地开发和运行您的第一个HUAWEI Research研究项目,您已经成功学会了:
- 如何使用HUAWEI Research的开放能力;
- 如何连接穿戴设备;
- 如何实现房颤主动测量;
- 如何获取房颤测量结果数据及研究数据如何上云存储。
剩余

