主题订阅消息推送，让用户不再错过重要信息

Posted 2021-05-29 华为移动服务

现今智能终端App越来越多，各个App推送的信息量急速扩张，如何让自己推送的信息精准抓住用户的视线，在市场竞争中占据高地？其中一个答案就是——主题订阅消息推送。

主题订阅消息推送可以根据用户习惯或让用户自定义感兴趣主题，应用再根据需要撰写主题消息，推送服务负责将消息可靠地传送至正确的设备，从而实现精准推送。例如，某个天气预报应用的用户可选择加入“X市天气”主题，并接收关于本地天气的通知。

华为主题订阅消息推送服务具有稳定、及时、高效的特点，多种推送样式、自动推送通知、Deep linking能够助力应用精准触达用户，有效提升用户活跃度和粘度。

接下来，我们详细解析如何集成华为主题订阅消息推送服务。

一、整体开发流程

Step1：应用App主题订阅；
Step2：向订阅主题的用户群发送消息；
Step3：验证主题订阅消息成功送达。

服务端主题订阅推送消息交互流程图

主题订阅有两种实现方式：App客户端主题订阅和服务端主题订阅。本文将分别详细介绍这两种订阅方式的实现步骤及代码。

二、集成关键步骤说明和代码实现

（一）客户端主题订阅

客户端主题订阅代码实现：

public void subtopic(View view) {
    String SUBTAG = "subtopic";
    String topic = "weather";
    try {
        // 主题订阅
    HmsMessaging.getInstance(PushClient.this).subscribe(topic).addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.i(SUBTAG, "subscribe topic weather successful");
                } else {
                    Log.e(SUBTAG, "subscribe topic failed,return value is" + task.getException().getMessage());
                }
            }
        });
    } catch (Exception e) {
        Log.e(SUBTAG, "subscribe faied,catch exception:" + e.getMessage());
    }
}

App端侧自定义订阅界面：

 主题订阅取消代码实现：

public void unsubtopic(View view) {
    String SUBTAG = "unsubtopic";
    String topic = "weather";
    try {
        // 主题订阅
        HmsMessaging.getInstance(PushClient.this).unsubscribe(topic).addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.i(SUBTAG, "unsubscribe topic successful");
                } else {
                    Log.e(SUBTAG, "unsubscribe topic failed,return value is" + task.getException().getMessage());
                }
            }
        });
    } catch (Exception e) {
        Log.e(SUBTAG, "subscribe faied,catch exception:" + e.getMessage());
    }
}

App端测自定义取消订阅界面：

（二）服务端主题订阅

1、获取Access Token。调用华为帐号服务器的接口（https://oauth-login.cloud.huawei.com/oauth2/v3/token），获取应用级鉴权凭证Access Token。

（1）请求消息：

POST /oauth2/v3/token HTTP/1.1
Host: oauth-login.cloud.huawei.com
Content-Type: application/x-www-form-urlencoded
 
grant_type=client_credentials&
client_id=<APP ID >&
client_secret=<APP secret >

（2）获取Access Token请求消息实战演示：

2、主题订阅与退订。服务器调用服务端主题订阅API或主题退订API进行应用主题订阅或退订，实现对应用主题的管理。主题订阅与退订的区别在于接口地址稍有不同，请求消息头和消息体均为一直，具体如下：

（1）主题订阅接口：

https://push-api.cloud.huawei.com/v1/[appid]/topic:subscribe

（2）主题取消订阅接口：

https://push-api.cloud.huawei.com/v1/[appid]/topic:unsubscribe

（3）请求消息头示例，此处Bearer Token为上一步获取的Access Token：

Authorization: Bearer CV0kkX7yVJZcTi1i+uk…Kp4HGfZXJ5wSH/MwIriqHa9h2q66KSl5
Content-Type: application/json

（4）请求消息体示例：

{
    "topic": "weather",
    "tokenArray": [
        "AOffIB70WGIqdFJWJvwG7SOB...xRVgtbqhESkoJLlW-TKeTjQvzeLm8Up1-3K7",
        "AKk3BMXyo80KlS9AgnpCkk8l...uEUQmD8s1lHQ0yx8We9C47yD58t2s8QkOgnQ"
    ]
}

（5）请求消息实战演示：

（三）发送主题消息

当创建完主题后，就可以根据主题发送消息，当前支持基于HTTPS协议进行主题消息发送。基于HTTPS协议示例报文如下：

{
    "validate_only": false,
    "message": {
        "notification": {
            "title": "message title",
            "body": "message body"
        },
        "android": {
            "notification": {
                "click_action": {
                    "type": 1,
                    "action": "com.huawei.codelabpush.intent.action.test"
                }
            }
        },
        "topic": "weather"
    }
}

App客户端测展示收到的推送消息：

三、主题订阅消息注意事项

客户端应用可以订阅任何现有主题，也可创建新主题。当客户端应用订阅新的主题名称尚不存在时，推送服务会使用这个名称创建一个新主题，随后任何客户端都可订阅该主题。

推送服务端给您提供了基本的主题管理API，支持一次1000个以内的Token订阅或者退订某个主题，同时每个应用最多只能存在2000个不同的主题。

主题与Token的订阅关系生效需等待一分钟，待订阅关系生效后，可以通过指向Topic或者组合Topic条件的方式实现消息批量发送。

>>访问华为推送服务官网，了解更多相关内容
>>获取华为推送服务开发指导文档
>>华为HMS Core官方论坛
>>华为推送服务开源仓库地址：GitHub、Gitee

点击右上角头像右方的关注，第一时间了解华为移动服务最新技术~