简介

华为情景感知服务(Huawei Awareness Kit)为您提供获取用户当前时空、活动状态、耳机状态、信标等情景感知组合能力。调用这些能力,您的app可以通过更高效的方式,洞悉用户当前所处的情景,为用户提供更加智慧和贴心的体验。

您可以调用Capture API或Barrier API:

您将建立什么

在这个Codelab中,你将创建一个调用华为情景感知服务的应用。

您将会学到什么

硬件要求

软件要求

集成HUAWEI HMS Core能力,需要完成以下准备工作

具体操作,请按照《HUAWEI HMS Core集成准备》中详细说明来完成。

针对Android tudio开发环境,华为提供了maven仓集成方式的HMS SDK包。在开始开发前,您需要将HMS SDK集成到您的Android Studio开发环境中。

在Android Studio开发环境中添加当前应用的AppGallery Connect配置文件。

  1. 登录 AppGallery Connect 网站,选择"我的应用"。
  2. 在名称列表中找到应用所在的产品,点击对应手机设备的"Android应用"链接。
  3. 选择"开发 > 概览"。
  4. 单击"应用"栏下的agconnect-services.json下载配置文件。
  5. agconnect-services.json文件拷贝到应用级根目录下。

配置HMS SDK的maven仓地址。

  1. 打开Android Studio项目级build.gradle文件。
  2. allprojects ->repositories里面配置HMS SDK的maven仓地址。
    allprojects { repositories { maven { url 'http://developer.huawei.com/repo/' } google() jcenter() } }
  3. buildscript -> repositories里面配置HMS SDK的maven仓地址。
    buildscript { repositories { maven { url 'http://developer.huawei.com/repo/' } google() jcenter() } dependencies { classpath 'com.android.tools.build:gradle:3.3.0' } }
  4. buildscript ->dependencies里面增加配置。
    buildscript{ dependencies { classpath 'com.huawei.agconnect:agcp:1.2.0.300' } }

添加编译依赖。

  1. 打开应用级build.gradle文件
  2. 在build.gradle文件中增加如下配置。
    compileOptions { sourceCompatibility = 1.8 targetCompatibility = 1.8 }
  3. 在dependencies中添加如下编译依赖,{version} 需要替换为实际的SDK版本号,如:implementation 'com.huawei.hms:awareness:1.0.1.300'
    dependencies{ implementation 'com.huawei.hms:awareness:{version}' }
  4. 在文件头添加配置。
    apply plugin: 'com.huawei.agconnect'
  5. 重新打开修改完的build.gradle文件,右上方出现Sync Now链接。点击Sync Now等待同步完成。如果出现错误,请检查网络连接是否正常,以及检查gradle文件是否正确。

配置混淆脚本

开发者编译APK前需要配置不要混淆HMS SDK,避免功能异常。

  1. 打开Android工程的混淆配置文件。
  2. 加入排除HMS SDK的混淆配置。
    -ignorewarnings -keepattributes *Annotation* -keepattributes Exceptions -keepattributes InnerClasses -keepattributes Signature -keepattributes SourceFile,LineNumberTable -keep class com.hianalytics.android.**{*;} -keep class com.huawei.updatesdk.**{*;} -keep class com.huawei.hms.**{*;}
  3. 如果开发者使用了AndResGuard,需要在混淆配置文件中加入AndResGuard白名单。
    "R.string.hms*", "R.string.connect_server_fail_prompt_toast", "R.string.getting_message_fail_prompt_toast", "R.string.no_available_network_prompt_toast", "R.string.third_app_*", "R.string.upsdk_*", "R.layout.hms*", "R.layout.upsdk_*", "R.drawable.upsdk*", "R.color.upsdk*", "R.dimen.upsdk*", "R.style.upsdk*", "R.string.agc*"

在Manifest指定权限

在调用情景感知能力时,开发者需要先在Manifest中指定相应的权限。使用不同情景感知能力需指定不同的权限,具体所需权限请参阅《开发指南》。例如,使用耳机状态感知能力,需要开启设备的蓝牙功能,需要在Manifest中申请蓝牙权限:

<!--蓝牙权限 --> <uses-permission android:name="android.permission.BLUETOOTH" />

导入接口类

在调用不同的情景感知能力时,开发者需要导入相应的能力接口类。不同能力所需的类的路径和类名不同,具体请参阅《API参考》。例如,使用耳机状态感知能力,除需要导入情景感知服务的公共能力类外,还需要导入耳机状态相关的类。

import com.huawei.hmf.tasks.OnFailureListener; import com.huawei.hmf.tasks.OnSuccessListener; import com.huawei.hms.kit.awareness.Awareness; //import headset capture package import com.huawei.hms.kit.awareness.capture.HeadsetStatusResponse; import com.huawei.hms.kit.awareness.status.HeadsetStatus;

Capture能力开发

  1. 获取Awareness Kit的CaptureClient
  2. 通过CaptureClient调用状态查询能力接口查询情景状态。
  3. 监听情景感知服务结果返回,进行应用的业务处理。以查询耳机状态为例:
    Awareness.getCaptureClient(this) .getHeadsetStatus() .addOnSuccessListener(new OnSuccessListener<HeadsetStatusResponse>() { @Override public void onSuccess(HeadsetStatusResponse headsetStatusResponse) { HeadsetStatus headsetStatus = headsetStatusResponse.getHeadsetStatus(); int status = headsetStatus.getStatus(); } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { Log.e("TAG",e.getMessage()); } });

Barrier能力开发

以下以开发耳机Connecting的Barrier为例(耳机连接时触发Barrier)。

  1. 定义Barrier。
    AwarenessBarrier barrier = HeadsetBarrier.connecting();
  2. 定义Barrier的PendingIntent,本示例中为发送一个广播,同时新建一个广播接收器用来接收这个广播。
    private PendingIntent mPendingIntent; private BarrierReceiver mBarrierReceiver; final String BARRIER_RECEIVER_ACTION = getApplication().getPackageName() + "BARRIER_RECEIVER_ACTION"; Intent intent = new Intent(BARRIER_RECEIVER_ACTION); mPendingIntent = PendingIntent.getBroadcast(this, 1, intent, PendingIntent.FLAG_UPDATE_CURRENT); mBarrierReceiver = new BarrierReceiver(); registerReceiver(mBarrierReceiver, new IntentFilter(BARRIER_RECEIVER_ACTION));
  3. 添加Barrier。
    String headsetBarrierLabel = "headset_connecting"; BarrierUpdateRequest.Builder builder = new BarrierUpdateRequest.Builder(); BarrierUpdateRequest request = builder.addBarrier(headsetBarrierLabel, barrier,mPendingIntent).build(); Task<Void> task = Awareness.getBarrierClient(this).updateBarriers(request); task.addOnSuccessListener( new OnSuccessListener<Void>() { @Override public void onSuccess(Void aVoid) { Toast.makeText(getApplicationContext(), "add barrier success", Toast.LENGTH_SHORT).show(); } }) .addOnFailureListener( new OnFailureListener() { @Override public void onFailure(Exception e) { Toast.makeText(getApplicationContext(), "add barrier failed", Toast.LENGTH_SHORT).show(); Log.e(TAG, "add barrier failed", e); } });
  4. 定义广播接收器,用于监听Barrier事件,收到事件后进行应用的业务处理。
    class BarrierReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { BarrierStatus barrierStatus = BarrierStatus.extract(intent); String label = barrierStatus.getBarrierLabel(); switch(barrierStatus.getPresentStatus()) { case BarrierStatus.TRUE: logView.printLog(label + " status:true"); break; case BarrierStatus.FALSE: logView.printLog(label + " status:false"); break; case BarrierStatus.UNKNOWN: logView.printLog(label + " status:unknown"); break; } } }

当您集成SDK后,可以通过日志和实际情况的对比,来判断调用是否成功。例如,当您的耳机处于为未连接状态,且点击"get Headset Status"按钮后日志显示为"Headsets are disconnected",说明调用Capture成功。

干得好,你已经成功完成了Codelab并学到了:

如需了解更多与华为Awareness Kit相关的信息,请关注我们的官方网站。开发过程中如果遇见问题,请参考我们的常见问题解答。

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

本Codelab中的demo源码下载地址如下:

源码下载

已复制代码