java集成华为推送

2021-04-10 02:28

阅读:539

集成华为推送

这类推送一般官方文档都比较详细,如果想要更加详细的了解建议查看官方文档。

官方文档地址:https://developer.huawei.com/consumer/cn/service/hms/pushservice.html

华为推送服务在开发前需要些准备 1.注册认证成为开发者

2.配置应用签名

3.创建产品和应用

4.开通推送服务

这些步骤按照官方文档一步步来就行,我这边是直接拿到了开发所需要的APPID,APP SECRET,PACKAGE NAME

注册和准备工作完成后就可以开始进行后台的代码编写了

第一步 应用服务器获取AccessToken

想要访问华为的服务接口必须需要一个Token,我们第一步就是获取这个Token。

    private static String appSecret = "appSecret";//用户在华为开发者联盟申请Push服务获取的服务参数
    private static  String appId = "12345678";//用户在华为开发者联盟申请Push服务获取的服务参数
    private static  String tokenUrl = "https://login.cloud.huawei.com/oauth2/v2/token"; //获取认证Token的URL
    private static  String apiUrl = "https://api.push.hicloud.com/pushsend.do"; //应用级消息下发API
    private static  String accessToken;//下发通知消息的认证Token
    private static  long tokenExpiredTime;  //accessToken的过期时间

首先定义好需要的参数,在实际开发中这些参数可以存放在数据库,也可以存放在配置文件中,看个人需求。

接下来就是获取Token

private void refreshToken() {
        try {
            String msgBody = MessageFormat.format("grant_type=client_credentials&client_secret={0}&client_id={1}", URLEncoder.encode(appSecret, "UTF-8"), appId);
            String response = HttpUtil.post(tokenUrl, msgBody);
            JSONObject obj = JSONObject.parseObject(response);
            accessToken = obj.getString(“access_token”);
            tokenExpiredTime = System.currentTimeMillis()+(obj.getLong(“expires_in”)-5 * 60)*1000;
        } catch (Exception e) {
            LOGGER.error("HvPush -- >> 认证Token获取失败!原因:e = {}", ExceptionUtil.getMessage(e));
        }
    }

获取到了访问Token我们就可以开始推送代码的编写了。

第二步 应用服务器发送PUSH消息

通过前面的代码我们获取到了AccessToken,Token的存放按照不同的需求可以放在redis或者数据库。

在发送消息之前首先先验证AccessToken是否已经过期

if(tokenExpiredTime 

接下来进行消息体的封装

    // 封装推送消息body,用于显示通知栏消息显示的标题和内容
    JSONObject body = new JSONObject();//仅通知栏消息需要设置标题和内容,透传消息key和value为用户自定义
    body.put("title","Push message title");//消息标题
    body.put("content","Push message content");//消息内容体

    // 封装消息点击动作的参数,“com.huawei.hms.hmsdemo”为推送消息中需要打开的应用APK包名。请根据实际包名来修改。
    JSONObject param = new JSONObject(); 
    param.put("appPkgName","com.huawei.hms.hmsdemo");//定义需要打开的appPkgName,这个参数在推送服务管理页面可以看到

    // 封装消息点击动作,用于定义通知栏点击行为
    JSONObject action = new JSONObject();
    action.put("type",3);//类型3为打开APP,其他行为请参考接口文档设置
    action.put("param",param);//消息点击动作参数
	
	// type为1时可以自定义行为,自定义行为需要app开发者事先给号参数
	// param.put("intent", "自定义行为,动作需要app开发者编辑好给你");

    // 封装消息类型,用于定义消息类型,区分是通知栏消息还是透传消息。
    JSONObject msg = new JSONObject();
    msg.put("type",3);//3: 通知栏消息,异步透传消息请根据接口文档设置
    msg.put("action",action);//消息点击动作
    msg.put("body",body);//通知栏消息body内容示例代码

    // 封装扩展消息,扩展消息中可以设置biTag用于消息打点,也可以携带customize参数用于触发通知栏点击事件的onEvent回调。
    JSONObject ext = new JSONObject();//扩展信息,含BI消息统计,特定展示风格,消息折叠。
    ext.put("biTag","Trump");//设置消息标签,如果带了这个标签,会在回执中推送给CP用于检测某种类型消息的到达率和状态
    JSONObject temp = new JSONObject();
    temp.put("season","Spring");
    temp.put("weather","raining");
    JSONArray customize = new JSONArray();
    customize.add(temp);
    ext.put("customize",customize);
    // ext扩展信息这个参数我并没理解到到底是干嘛的 ,在实际的开发中我只使用了ext.put("biTag", "Trump"); 并没有进行customize参数的携带

    // 最后将以上信息全部封装整个消息体
    JSONObject hps = new JSONObject();//华为PUSH消息总结构体
    hps.put("msg",msg);
    hps.put("ext",ext);
    JSONObject payload = new JSONObject();
    payload.put("hps",hps);

消息体参数详细文档地址:https://developer.huawei.com/consumer/cn/service/hms/catalog/huaweipush_agent.html?page=hmssdk_huaweipush_api_reference_agent_s2

消息体封装完成后就可以开始发送推送消息了。

	// 创建一个数组json用于存放需要推送的设备id,一般是由前段传过来,或者数据库查询出来
	JSONArray deviceTokens = new JSONArray();//目标设备Token
        deviceTokens.add(regId);

	// 封装整个http消息并发送
	String postBody = MessageFormat.format(
         "access_token={0}&nsp_svc={1}&nsp_ts={2}&device_token_list={3}&payload={4}",
            URLEncoder.encode(accessToken,"UTF-8"),
            URLEncoder.encode("openpush.message.api.send","UTF-8"),
            URLEncoder.encode(String.valueOf(System.currentTimeMillis() / 1000),"UTF-8"),
            URLEncoder.encode(deviceTokens.toString(),"UTF-8"),
            URLEncoder.encode(payload.toString(),"UTF-8"));

String postUrl = apiUrl + "?nsp_ctx=" + URLEncoder.encode("{\"ver\":\"1\", \"appId\":\"" + appId + "\"}", "UTF-8");

	// 发送消息 这里我用的是hutool的HttpUtil工具类发的post请求
        String post = HttpUtil.post(postUrl, postBody);
        LOGGER.info("华为推送 -- >> 返回结果:" + post);

到此推送完成,返回结果与错误代码对应文档地址:https://developer.huawei.com/consumer/cn/service/hms/catalog/huaweipush_agent.html?page=hmssdk_huaweipush_api_reference_agent_s2


评论


亲,登录后才可以留言!