如何用Nearby Service开发针对附近人群的精准广告推送功能

  当你想找一家餐厅吃饭，却不知道去哪家，这时候手机跳出一条通知，为你自动推送附近优质餐厅的信息，你会点击查看吗？当你还在店内纠结于是否买下一双球鞋时，手机应用给了你发放了老顾客5折优惠券，这样的广告你有拒绝的理由吗？

  这样的广告不仅不会引起用户的厌烦，还满足了用户的需求。更准确的广告推送，减少对用户不必要的打扰，提高用户对应用的满意度。那如何才能给自己的APP增加一个针对附近人群的精准广告推送功能呢？

  可以接入华为近距离通信服务，通过蓝牙信标消息订阅功能（Nearby Beacon Message）来实现. 在商场中部署Beacon，Beacon消息提供精确的相对位置信息，当用户走近餐厅、商店时，就会收到本店预先配置好的促销消息，例如优惠券、打折信息等等，从而可以很便捷的对本店进行推广，下图是功能演示。

  如果你对实现方式感兴趣，可以在Github上下载源码：

  https://github.com/HMS-Core/hms-nearby-demo/tree/master/NearbyCanteens

1.开发准备

  如果您已经是华为的开发者，可以省略此步骤。如果您以前没有集成华为移动服务的经验，那么需要先配置AppGallery Connect，开通近距离通信服务并集成HMS SDK。相关步骤请参考官方文档。

1.1 在项目级gradle里添加华为maven仓和agcp配置

  增量添加如下maven地址和agcp配置，以下不用修改，拷贝即可。

buildscript {
     repositories {
         google()
         jcenter()
         maven { url 'http://developer.huawei.com/repo/' }
     }
     dependencies {
         classpath 'com.android.tools.build:gradle:3.4.1'
         classpath 'com.huawei.agconnect:agcp:1.2.1.301'
     }
 }

 allprojects {
     repositories {
         google()
         jcenter()
         maven { url 'http://developer.huawei.com/repo/' }
     }
 }

1.2 在应用级的build.gradle里面加上SDK依赖

  把近距离通信服务SDK引入，最重要的是以下com.huawei开头的SDK。

dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
     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.hmf:tasks:1.3.1.301"
     implementation "com.huawei.hms:network-grs:1.0.9.302"
     implementation 'com.huawei.agconnect:agconnect-core:1.2.1.301'
     implementation 'com.huawei.hms:nearby:4.0.4.300'
     api 'com.google.code.gson:gson:2.8.5'
 }

1.3 在AndroidManifest.xml文件里面申请网络权限、蓝牙权限和位置权限

  以下权限见名知义，比如android.permission.INTERNET就是需要网络权限，android.permission.BLUETOOTH就是需要蓝牙权限。以下权限都是必须的。

<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
 <uses-permission android:name="android.permission.INTERNET" />
 <uses-permission android:name="android.permission.BLUETOOTH" />
 <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
 <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
 <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
 <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

2. 代码开发

2.1 初始化以及动态权限申请

  onCreate是当前activity创建时会调用的方法，在这个方法里头，我们可以做一些准备动作，比如必要权限的申请，以及检查手机网络、蓝牙、GPS是否开启等。

@RequiresApi(api = Build.VERSION_CODES.P)
 @Override
 protected void onCreate(Bundle savedInstanceState) {
     super.onCreate(savedInstanceState);
     Log.i(TAG, "onCreate");
     setContentView(R.layout.activity_canteen);
     boolean isSuccess = requestPermissions(this, this);
     if (!isSuccess) {
         return;
     }
     Log.i(TAG, "requestPermissions success");
     if (!NetCheckUtil.isNetworkAvailable(this)) {
         showWarnDialog(Constant.NETWORK_ERROR);
         return;
     }
     if (!BluetoothCheckUtil.isBlueEnabled()) {
         showWarnDialog(Constant.BLUETOOTH_ERROR);
         return;
     }
     if (!GpsCheckUtil.isGpsEnabled(this)) {
         showWarnDialog(Constant.GPS_ERROR);
         return;
     }
     intView();
     init();
 }

  注册监听，当检测到手机蓝牙、GPS、网络未连接时，给出提示： 以下使用的是Android中的AlertDialog组件来做提示。

private void showWarnDialog(String content) {
     DialogInterface.OnClickListener onClickListener =
         new DialogInterface.OnClickListener() {
             @Override
             public void onClick(DialogInterface dialog, int which) {
                 android.os.Process.killProcess(android.os.Process.myPid());
             }
         };
     AlertDialog.Builder builder = new AlertDialog.Builder(this);
     builder.setTitle(R.string.warn);
     builder.setIcon(R.mipmap.warn);
     builder.setMessage(content);
     builder.setNegativeButton(getText(R.string.btn_confirm), onClickListener);
     builder.show();
 }

2.2 接收Beacon消息的过程

  以下这个startScanning方法，是在onStart方法中被调用的，表示开始启动蓝牙扫描，并且以下的MessageHandler对象中，封装了4个回调方法（onFound表示获取到beacon消息，OnLost表示消息丢失，onDistanceChanged表示beacon与本手机的距离变化，onBleSignalChanged表示监测到beacon的信号变化）。

  最重要的就是以下的doOnFound方法，表示接收到beacon消息时，客户端的处理方式，可以做个性化展示。

private void doOnFound(Message message) {
     if (message == null) {
         return;
     }
     String type = message.getType();
     if (type == null) {
         return;
     }
     String messageContent = new String(message.getContent());
     Log.d(TAG, "New Message:" + messageContent + " type:" + type);
     if (type.equalsIgnoreCase(Constant.CANTEEN)) {
         operateOnFoundCanteen(messageContent);
     } else if (type.equalsIgnoreCase(Constant.NOTICE)) {
         operateOnFoundNotice(messageContent);
     }
 }

自定义展示：

  下面的方法只是简单的演示其中一种消息处理方式，包括客户端上的通知栏横幅通知、页面字体滑动展示等操作。

private void operateOnFoundCanteen(String messageContent) {
     CanteenAdapterInfo canteenAdapterInfo =
             (CanteenAdapterInfo) JsonUtils.json2Object(messageContent, CanteenAdapterInfo.class);
     if (canteenAdapterInfo == null) {
         return;
     }
     String canteenName = canteenAdapterInfo.getCanteenName();
     if (canteenName == null) {
         return;
     }
     Log.d(TAG, "canteenName:" + canteenName);
     if (!canteenNameList.contains(canteenName)) {
         return;
     }

     String notice = "";
     if (receivedNoticeMap.containsKey(canteenName)) {
         notice = receivedNoticeMap.get(canteenName);
     }
     int canteenImage = getCanteenImage(canteenName);
     int requestCode = getRequestCode(canteenName);
     canteenAdapterInfo.setNotice(notice);
     canteenAdapterInfo.setCanteenImage(canteenImage);
     canteenAdapterInfo.setShowNotice(true);
     canteenAdapterInfo.setRequestCode(requestCode);

     canteenAdapterInfoMap.put(canteenName, canteenAdapterInfo);
     canteenAdapterInfoList.add(canteenAdapterInfo);

     sendNotification(Constant.NOTIFICATION_TITLE, Constant.NOTIFICATION_SUBTITLE, canteenName, requestCode);
     runOnUiThread(
         new Runnable() {
             @Override
             public void run() {
                 searchTipTv.setText(R.string.found_tip);
                 loadingLayout.setVisibility(View.GONE);
                 canteenAdapter.setDatas(canteenAdapterInfoList);
             }
         });
 }

---

结后语

  本次给大家演示的demo用到了华为Nearby Service的蓝牙信标消息订阅功能

  基于Nearby Beacon Message能力不仅仅可以用来做广告推送，还可以实现如下相关功能：

1. 汽车生活类应用集成Nearby Beacon Message功能后，可以识别用户靠近汽车，通知App启用无钥匙进入，记录行驶轨迹等。

2. 办公类应用集成Nearby Beacon Message功能后，可快速准确记录员工打卡位置。

3. 旅游、展览类应用集成Nearby Beacon Message功能后，当用户靠近某个展品或文物时候，能够获取相应的介绍信息。

4. 游戏类应用使用Nearby Beacon Message，可以实现游戏和现实场景互动。通过现实物体触发游戏关卡，或者对参与线下活动的游戏玩家给予游戏道具奖励。

  更详细的开发指南可参考华为开发者联盟官网

---

往期链接：超简单集成ML kit 实现听写单词播报

原文链接：https://developer.huawei.com/consumer/cn/forum/topicview?tid=0201283747724140328&fid=18

原作者：赵照