华为Awareness kit，您旅途路上的超智能管家

飞奔的炮台

前言
前段时间看了一部纪录片《中国游客在巴黎》，讲述了外国人眼中“中国式旅游”：热衷景点打卡，沉迷拍照留念，无暇仔细欣赏；留足时间，买买买，不能枉此行。网友总结中国式旅游“上车睡觉，下车拍照，回到家啥也不知道”，可以说是小编本编了。我赶紧“反思”了下，觉得纯粹是因为我懒，不想做旅游攻略，只能跟团到“人从众”景点欣赏别人的后脑勺。每逢此刻，我就想有个可以推荐旅游行程、适时出行提示、推荐衣食住票信息等的全能“管家”。
重点来了，华为推出的Awareness Kit情景感知服务完全可以实现这些功能和服务，并且完全免费，这简直就是造福懒人旅游的必备神器啊！
旅游出行应用场景
华为情景感知服务（HUAWEI Awareness Kit）通过提供获取用户当前时间、位置、活动状态、音频设备状态、环境光、天气、信标等情景感知组合能力，并调用这些能力，帮助App更快速、高效的洞悉用户当前所处的情景，提供更加智慧、贴心的体验。
外出旅行时，在Awareness Kit支持下，天气感知能力提醒用户准备合适旅行衣服，位置感知能力推荐出行、餐饮、景点、票务等信息，时间和天气感知能力提醒日出/日落等信息，让用户获得超贴心的旅伴服务。

关键开发代码
开发准备
1、配置AppGallery Connect。
2、集成HMS Core SDK。
3、配置混淆脚本。
具体操作参考官网：配置AppGallery Connect
接口调用代码
1、指定权限
在调用位置、天气、时间等能力时，开发者需要先在Manifest中指定相应的权限。
2、导入接口类
开发者在使用各项感知能力时，需要导入情景感知服务的公共能力和与各项功能状态相关的类。比如：时间感知能力导入接口类

import com.huawei.hmf.tasks.OnFailureListener;
import com.huawei.hmf.tasks.OnSuccessListener;
import com.huawei.hms.kit.awareness.Awareness;
//导入时间快照相关类
import com.huawei.hms.kit.awareness.capture.TimeCategoriesResponse;
import com.huawei.hms.kit.awareness.status.TimeCategories;
//导入时间围栏相关类
import com.huawei.hms.kit.awareness.barrier.AwarenessBarrier;
import com.huawei.hms.kit.awareness.barrier.BarrierStatus;
import com.huawei.hms.kit.awareness.barrier.TimeBarrier;
import com.huawei.hms.kit.awareness.barrier.BarrierUpdateRequest;

3、Capture能力开发
Capture API允许app请求用户当前状态，如用户当前时间、位置、活动状态、设备状态等。
（1）获取Awareness kit的“Capture Client”。
（2）通过“Capture Client”调用时间状态查询能力接口查询情景状态。
（3）监听情景感知服务结果返回，进行应用的业务处理。
例如：天气感知能力

Awareness.getCaptureClient(this).getWeatherByDevice()
    .addOnSuccessListener(new OnSuccessListener<WeatherStatusResponse>() {
      @Override
      public void onSuccess(WeatherStatusResponse weatherStatusResponse) {
        WeatherStatus weatherStatus = weatherStatusResponse.getWeatherStatus();
        WeatherSituation weatherSituation = weatherStatus.getWeatherSituation();
        Situation situation = weatherSituation.getSituation();
        // 更多返回的天气数据信息可参考华为开发者文档
        String weatherInfoStr = "City:" + weatherSituation.getCity().getName() + "\n" +
            "Weather id is " + situation.getWeatherId() + "\n" +
            "CN Weather id is " + situation.getCnWeatherId() + "\n" +
            "Temperature is " + situation.getTemperatureC() + "℃" +
            "," + situation.getTemperatureF() + "℉" + "\n" +
            "Wind speed is " + situation.getWindSpeed() + "km/h" + "\n" +
            "Wind direction is " + situation.getWindDir() + "\n" +
            "Humidity is " + situation.getHumidity() + "%";
        Log.i(TAG, weatherInfoStr);
      }
    })
    .addOnFailureListener(new OnFailureListener() {
      @Override
      public void onFailure(Exception e) {
        Log.e(TAG, "get weather failed");
      }
    });
```
**4、Barrier能力开发**

Barrier API可以为app设定情景状态的“围栏”，当用户状态达到预设情景状态时，情景感知服务会触发app发送通知。

以开发地理围栏“enter”的“Barrier“为例，进入设定的位置范围后触发Barrier。

（1）定义Barrier。

AwarenessBarrier enterBarrier = LocationBarrier.enter(latitude, longitude, radius);

（2）定义Barrier状态改变时触发的“PendingIntent”。

（3）定义Barrier对应的标签Label，然后添加Barrier。

String locationBarrierLabel = "location enter barrier";
BarrierUpdateRequest.Builder builder = new BarrierUpdateRequest.Builder();
BarrierUpdateRequest request = builder.addBarrier(locationBarrierLabel, enterBarrier,pendingIntent).build();
Awareness.getBarrierClient(context).updateBarriers(request)
.addOnSuccessListener(new OnSuccessListener() {
@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 LocationBarrierReceiver 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:
        Log.i(TAG, label + " status:true");
        break;
      case BarrierStatus.FALSE:
        Log.i(TAG, label + " status:false");
        break;
      case BarrierStatus.UNKNOWN:
        Log.i(TAG, label + " status:unknown");
        break;
    }
  }
}

以上是部分功能的接口调用示例代码。
更详细的开发指南请参考华为开发者联盟-情景感知服务官网
结束语
华为情景感知服务通过调用时间、位置、天气、活动状态、设备状态等功能，广泛应用于旅游出行、运动健康、音乐、游戏、摄影等app，为用户提供更智慧、更贴心的体验。
【情景感知服务】精品开发案例介绍
【情景感知服务】让你的音乐APP脱颖而出，更懂用户，也更动人心
【情景感知服务】让“买买买”有了新的打开方式
访问华为开发者联盟官网
获取开发指导文档
华为移动服务开源仓库地址：GitHub、Gitee
关注我们，第一时间了解 HMS Core 最新技术资讯~