剩余37分钟读完

HUAWEI Research服务

剩余37分钟读完
Read mode

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的开放能力;
  • 如何连接穿戴设备;
  • 如何实现房颤主动测量;
  • 如何获取房颤测量结果数据及研究数据如何上云存储。

8. 参考

您可以阅读下面链接,了解更多相关的信息。
相关文档

您可以点击下方按钮下载源码。

下载源码

已复制代码