主题订阅消息推送,让用户再也不错太重要信息

2021年09月15日 阅读数:5
这篇文章主要向大家介绍主题订阅消息推送,让用户再也不错太重要信息,主要内容包括基础应用、实用技巧、原理机制等方面,希望对大家有所帮助。
 

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

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

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

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

1、总体开发流程

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

主题订阅消息推送,让用户再也不错太重要信息_客户端

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

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

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

(一)客户端主题订阅app

客户端主题订阅代码实现:ide

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端侧自定义订阅界面:this

主题订阅消息推送,让用户再也不错太重要信息_oauth_02

主题订阅取消代码实现:

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端测自定义取消订阅界面:

主题订阅消息推送,让用户再也不错太重要信息_oauth_03

(二)服务端主题订阅

一、获取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请求消息实战演示:

主题订阅消息推送,让用户再也不错太重要信息_客户端_04

二、主题订阅与退订。服务器调用服务端主题订阅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)请求消息实战演示:

主题订阅消息推送,让用户再也不错太重要信息_oauth_05

主题订阅消息推送,让用户再也不错太重要信息_github_06

(三)发送主题消息

当建立完主题后,就能够根据主题发送消息,当前支持基于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客户端测展现收到的推送消息:

主题订阅消息推送,让用户再也不错太重要信息_gitee_07

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

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

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

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