Cordova插件--极光推送

一、什么是极光推送

• 极光推送

  通过极光发送各个移动平台的系统通知，网址：https://www.jiguang.cn/push?source=bdjj#B_vid=12785778959110824941

二、cordova插件的安装

• Install

  • 通过 Cordova Plugins 安装，要求 Cordova CLI 5.0+：

    cordova plugin add jpush-phonegap-plugin --variable APP_KEY=your_jpush_appkey
    

  • 或直接通过 url 安装：

    cordova plugin add https://github.com/jpush/jpush-phonegap-plugin.git --variable APP_KEY=your_jpush_appkey
    

  • 或下载到本地安装：

    cordova plugin add Your_Plugin_Path --variable APP_KEY=your_jpush_appkey
    

  • 说明

    • 在使用 Xcode 8 调试 iOS 项目时，需要先在项目配置界面的 Capabilities 中打开 Push Notifications 开关。
    • variable APP_KEY=your_jpush_appkey ，举例：variable APP_KEY=354fb5c3dd4249ec11bc545d
    • 官方网址，https://github.com/jpush/jpush-phonegap-plugin/blob/master/doc/Common_detail_api.md

三、插件的使用

1、通用API

• 初始化，获取集成日志

  //初始化一般放在页面初始的JS中，例如app.js		
  //启动极光推送服务；
  window.plugins.jPushPlugin.init();
  //调试模式；        
  window.plugins.jPushPlugin.setDebugMode(true);
  

• 获取设备号

  //res就是设备号
  window.plugins.jPushPlugin.getRegistrationID(function(res){
         }
  

• 关闭推送服务

    window.plugins.jPushPlugin.stopPush();
  

• 重启推送服务

  window.plugins.jPushPlugin.resumePush();
  

• 判断服务状态

      window.plugins.jPushPlugin.isPushStopped(function (result) {
         
          if (result == 0) {
         
            // 开启
          } else {
         
            // 关闭
          }
        })
  

  ​

2、IOS API

• ios角标设置与清零

     if (ionic.Platform.isIOS()) {
         
              if (window.plugins.jPushPlugin) {
         
                window.plugins.jPushPlugin.setApplicationIconBadgeNumber(0);
                window.plugins.jPushPlugin.resetBadge();
              }
            }
  

• 点击消息事件监听

      if(ionic.Platform.isIOS()){
         
              if (window.plugins.jPushPlugin) {
         
                  document.addEventListener("jpush.openNotification", function(event){
         
                      // var alertContent = event.aps.alert
                      // alert("open notification:" + alertContent);
                      window.plugins.jPushPlugin.setApplicationIconBadgeNumber(0);
                      window.plugins.jPushPlugin.resetBadge();
                  }, false);
              }
            }
  

  备注： 官方网址，https://github.com/jpush/jpush-phonegap-plugin/blob/master/doc/iOS_API.md

3、android API

**备注：** 安卓无法获取角标值。具体的api 参考官方文档。https://github.com/jpush/jpush-phonegap-plugin/blob/master/doc/Android_detail_api.md

三、2018年3月13日更新

最近，极光推送进行了更新。导致安卓平台要求在7.0以上才可以。我目前所用的平台是[email protected]。所以要在安装插件的时候控制版本。

• 安装jcore

  cordova plugin add [email protected]
  

• 安装jpush

  cordova plugin add [email protected] --variable APP_KEY=xxxx
  

  ​