uni-app的unipush实现通知栏推送服务全过程

背景

说明文档这个事情官方应该提供出来,可惜官方觉得是多余的,免费的东西凭啥给你做好。于是我在这里叙述一下实现消息通知推送的步骤。

uni-app官方文档入口
https://uniapp.dcloud.io/api/plugins/push

uniPush官方使用指南
https://ask.dcloud.net.cn/article/35622

推送H5+API接口:
https://www.html5plus.org/doc/zh_cn/push.html

基础环境准备

2.1 DCLOUD平台配置

参考官方教程在dcloud中配置各个厂商的api和secret,这部分不是难点,有问题留言。
https://ask.dcloud.net.cn/article/35716
uni-app的unipush实现通知栏推送服务全过程_第1张图片

为啥要配置厂商呢:
为了在app关闭的时候,可以通过厂商的服务器推送消息给手机通知系统。第三方的消息推送会被阻挡,最好的方式就是按照厂商的要求接入各个推送服务。庆幸的事情,这部分DCLOUD已经帮你做好了。你只需要注册下各个厂商的开发平台,按到appid和secret登录dcloud后台即可。
uni-app的unipush实现通知栏推送服务全过程_第2张图片

2.1 Uni-app权限配置

uni-app的unipush实现通知栏推送服务全过程_第3张图片

2.3 准备自定制测试基座或者云打包

Hbuilder的基座配置的信息都是dcloud的,所以用被人的app是没办法测试推送服务的。解决这个问题有两种
1,云打包时打包成为自己的app后测试
2,制作自定义的基座(很简单),这个基座的信息都是自己的,所以可以测试
运行的时候选择自定制基座,或者直接云打包后的的apk安装到手机测试。

以上就准备好了基本环境

3 体验推送(帮助理解推送的过程)

3.1 APP端代码

代码位置只能在app.vue的onLaunch中,其他地方可能会有问题。

 //#ifdef APP-PLUS  
			 var info = plus.push.getClientInfo();
			console.log( JSON.stringify( info ) );
			 /* 5+  push 消息推送 ps:使用:H5+的方式监听,实现推送*/  
			plus.push.addEventListener("click", function(msg) {  
						console.log("click:"+JSON.stringify(msg));  
						console.log(msg.payload);  
						console.log(JSON.stringify(msg));  
						//这里可以写跳转业务代码
					}, false);  
						// 监听在线消息事件    
					plus.push.addEventListener("receive", function(msg) {  
						// plus.ui.alert(2);  
							//这里可以写跳转业务代码
						console.log("recevice:"+JSON.stringify(msg))  
			   }, false);  

		   //#endif  

这里就是官方文档比较恶心的地方,自己生命onpush之类的api废弃了,但是给的demo还是用的废弃的方式。推荐的H5+api却不给demo。要知道demo对我们就是api文档啊。

这里listener监听的两种事件

  • “click”-从系统消息中心点击消息启动应用事件;
  • “receive”-应用从推送服务器接收到推送消息事件。

上面方法准备好了app端的基本代码,这段代码实现了从推送中心获取消息的能力。具体的实现方式我们可以先不关注。

3.1 测试消息推送(无需服务器代码)

打开dcloud的后台,打开消息推送,填写消息,并点击预览
uni-app的unipush实现通知栏推送服务全过程_第4张图片
这里填写的cid就是APP代码段获取到的clientId,填入后预览系统提示发送成功。

 var info = plus.push.getClientInfo();
			console.log( JSON.stringify( info ) );

uni-app的unipush实现通知栏推送服务全过程_第5张图片
注意:

  1. 手机必须是云打包或者自定义基座运行的app
  2. 填写正确clientId,这个id定位了你的手机,可以理解为手机的ip。
  3. 手机通知权限要打开,要不你就等到天荒地老吧

服务器端代码java版本

step1:个推sdk导入


    com.gexin.platform
    gexin-rp-sdk-http
    4.1.0.5



    
        getui-nexus
        http://mvn.gt.igexin.com/nexus/content/repositories/releases/
    
 

java代简单版

下面代码填入后台申请的appId 、appKey 、masterSecret 后运行即可实现上述等同效果。

import com.gexin.rp.sdk.base.IPushResult;
import com.gexin.rp.sdk.base.impl.AppMessage;
import com.gexin.rp.sdk.http.IGtPush;
import com.gexin.rp.sdk.template.NotificationTemplate;
import com.gexin.rp.sdk.template.style.Style0;

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class PushTest {

    // STEP1:获取应用基本信息
    private static String appId = "";
    private static String appKey = "";
    private static String masterSecret = "";
    private static String url = "http://sdk.open.api.igexin.com/apiex.htm";

    public static void main(String[] args) throws IOException {

        IGtPush push = new IGtPush(url, appKey, masterSecret);

        Style0 style = new Style0();
        // STEP2:设置推送标题、推送内容
        style.setTitle("请输入通知栏标题");
        style.setText("请输入通知栏内容");
        style.setLogo("push.png");  // 设置推送图标
        // STEP3:设置响铃、震动等推送效果
        style.setRing(true);  // 设置响铃
        style.setVibrate(true);  // 设置震动


        // STEP4:选择通知模板
        NotificationTemplate template = new NotificationTemplate();
        template.setAppId(appId);
        template.setAppkey(appKey);
        template.setStyle(style);


        // STEP5:定义"AppMessage"类型消息对象,设置推送消息有效期等推送参数
        List appIds = new ArrayList();
        appIds.add(appId);
        AppMessage message = new AppMessage();
        message.setData(template);
        message.setAppIdList(appIds);
        message.setOffline(true);
        message.setOfflineExpireTime(1000 * 600);  // 时间单位为毫秒

        // STEP6:执行推送
        IPushResult ret = push.pushMessageToApp(message);
        System.out.println(ret.getResponse().toString());
    }
}

参考文档

DCLOUD完全依赖个推,所以个推的官方文档在uniapp的push模块完全适用。
官方API文档地址:http://docs.getui.com/getui/server/java/guide/
java后端github地址:https://github.com/GetuiLaboratory/getui-pushapi-java-demo
https://www.html5plus.org/doc/zh_cn/push.html#plus.push.PushReceiveCallback
https://ask.dcloud.net.cn/article/35622

感谢这个朋友提供了APP端的入口
https://ask.dcloud.net.cn/article/35630

你可能感兴趣的:(uni-app)