Uni-app实现推送Uni-push（Android）_uniapp push

作者：Monodyee | 2024-03-20 15:18:33

踩

uniapp push

提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档

文章目录

前言
一、unipush是什么？
二、使用步骤

前言

国内Android的Push是一个混乱的世界，因为 Google 的 Push 服务 FCM 被墙，所以一些国内的安卓手机厂商各自做了自己的推送，比如华为、小米、OPPO、VIVO、魅族等，但还有很多国产手机厂商没有提供官方推送方案。三方独立公司如个推，则提供了独立的 push 方案。
在没有 uniPush 以前，如果只使用三方 push，会在很多国产手机上因为节电设置而无法保活 push 进程，导致无法推送。
而如果每个安卓手机的官方 Push SDK 都集成开发一遍，这么多平台，工作量会非常巨大，管理维护也很麻烦。

uniPush 解决了这个难题，开发者只需要开发一次。系统会自动在不同手机上选择最可靠的推送通道发送 push 消息，保障送达率。

UniPush 即降低了开发成本、又提高了 push 送达率，并且免费，是当前推送的最佳解决方案。

提示：以下是本篇文章正文内容，下面案例可供参考

一、UniPush是什么？

UniPush 是 DCloud 联合个推公司推出的集成型统一推送服务，内建了苹果、华为、小米、OPPO、VIVO、魅族、谷歌 FCM 等手机厂商的系统级推送和个推等第三方推送。

二、使用步骤

1.开通Unipush推送服务

HBuilderX 本项目中打开manifest.json,选择“App 模块配置”，向下找到Push推送功能配置，勾选 “UniPush（集成各家手机厂商系统推送及个推）” 即可。

点击勾选的uniPush配置进入DCloud开发者中心

**注意：**在申请开通时，需要确保输入的 Android包名和 Android应用签名（签名信息可点击更多查看具体操作）必须与打包时配置的一致，否则可能会导致无法收到推送消息。

如果已经开通 Uni Push，会看到如下页面：

打开链接开发者中心https://dev.dcloud.net.cn/#/pages/app/push/thirdparty

Uni Push 集成并统一了各个手机厂商的系统级推送，目前支持魅族、OPPO、华为、小米、VIVO。如果需要使用厂商推送，需要先在各厂商开发者平台申请。
申请通过后厂商会提供推送的相关参数，需要将这些参数配置到 DCloud 开发者中心后台。
点击厂商推送设置选择当前应用项目页面如下图所示：

由于公司APP需求上线华为,打开AppGallery Connect网站，选择我的项目。打开刚才创建的项目，查看应用信息中相应的华为 AppID、华为 SecretKey。该信息在之后步骤中将会使用，如下图：

其他厂商具体流程点击厂商应用开通指南-个推文档中心查看详情。

2.java服务端下发消息内容

首先需要获取AppId、AppKey、MasterSecret参数，登录DCloud开发者中心，在“Uni Push”下的“应用配置”页面中获取，引入maven库文件，在线走内推，离线走个推，Java-sdk封装Rest-V2厂商推送示例：

完整服务端厂商推送教程参考：https://docs.getui.com/getui/server/rest_v2/common_args/


        <dependency>
            <groupId>com.gexin.platform</groupId>
            <artifactId>gexin-rp-sdk-http</artifactId>
            <version>4.1.2.1</version>
        </dependency>
 
        <repository>
            <id>getui-nexus</id>
            <url>http://mvn.gt.igexin.com/nexus/content/repositories/releases/</url>
        </repository>


public AjaxResult info( String commonApiModel ) {
        CommonInterfaceModel model = jsonToObject(commonApiModel,key,secret);
        if(model.isCheck()) {
            Order appPush = JSONObject.parseObject(model.getParameter(),Order.class);
            IGtPush push = new IGtPush(url, appKey, masterSecret);
 
            Style0 style = new Style0();
            // STEP2：设置推送标题、推送内容
            style.setTitle(appPush.getOdTitle());
            style.setText(appPush.getOdContent());
            // 设置推送图标
//            style.setLogo("./src/main/resources/static/push.png");
            // 配置通知栏网络图标
//            style.setLogoUrl("");
            // STEP3：设置响铃、震动等推送效果
            // 设置响铃
            style.setRing(true);
            // 设置震动
            style.setVibrate(true);
 
            // STEP4：选择通知模板
            NotificationTemplate template = new NotificationTemplate();
            template.setTransmissionType(1);
            template.setAppId(appId);
            template.setAppkey(appKey);
            template.setStyle(style);
 
            SingleMessage message = new SingleMessage();
            message.setOffline(true);
            // 离线有效时间，单位为毫秒
            message.setOfflineExpireTime(24 * 3600 * 1000);
            message.setData(template);
            // 可选，1为wifi，0为不限制网络环境。根据手机处于的网络情况，决定是否下发
            message.setPushNetWorkType(0);
 
            Target target = new Target();
            target.setAppId(appId);
            target.setClientId(appPush.getClientId());
 
            IPushResult ret = null;
            try {
                ret = push.pushMessageToSingle(message, target);
            } catch (RequestException e) {
                System.out.println(e.getMessage());
                ret = push.pushMessageToSingle(message, target, e.getRequestId());
            }
            if (ret != null) {
                System.out.println("返回结果=====" + ret.getResponse().toString());
            } else {
                System.out.println("服务器响应异常=====");
            }
            return AjaxResult.success(ret.getResponse().toString());
        } else {
            return AjaxResult.error("秘钥或参数错误");
        }
    }

3.测试预览

必须打包正式App安装到手机并要保证第一步（Android包名和Android应用签名）的操作没有问题，手机端通过plus.push.getClientInfo();获取CID客户端标识，也是下一步需要存到数据库的标识串，如下图：


// 获取App端cid
let CID= plus.push.getClientInfo();
console.log(CID)

4.手机端处理

需求是针对用户在审核过程中下发到指定人，此人就可以在手机上获得推送消息通知。大概逻辑比较简单，App端获取到cid，通过登录判断当前人是否要接消息通知，通过接口存到对应人的数据库，服务端再通过集成的个推sdk把对应的cid，下发给App端，来完成交互。个推，批量推，群推，可根据业务需求进行更改设定。

App.vue页面：


    // #ifdef APP-PLUS
		let timer = false;
		plus.push.addEventListener("click",(msg)=>{
			clearTimeout(timer);
			timer = setTimeout(()=>{
				console.log(1111,msg);
			},1500)
		},false)
		plus.push.addEventListener("receive",(msg)=>{
			if("LocalMSG" == msg.payload){
			}else{
				if(msg.type=='receive'){
					var options = {cover:false,title:msg.title};
					plus.push.createMessage(msg.content, msg.payload, options ); 
				 }  
			}
		},false)
	// #endif

登录页面：


let pinf = plus.push.getClientInfo();
let cid = pinf && pinf.clientid || ''; //客户端标识
// 登录根据userId更新存数据库clientId
//发送网络请求
let opts = {url: '/app/*****',method: 'post'}
this.$http.httpTokenRequest(opts,{clientId:cid,userId:res.data.data.userId}).then(res => {
    if(res.data.code == 200){
        //继续执行登录逻辑
	}else{
		uni.showToast({title: '登录异常，请联系管理员。',icon: "none",})
	}
})