mobPushPlus

当前 MobPush 版本，iOS：v1.7.2、android：v1.7.2

MobPush是Mob推出的一款免费的推送服务工具，客户端SDK支持iOS和Android两大平台，集成方便简单快捷，且提供完整的可视化数据和强大的管理后台。

MobPush 功能

支持通知栏通知和自定义消息。
可对通知和自定义通知进行定时发送。
可根据标签、别名、Registration ID、地理位置精确推送。
用户量，推送数量，成功数量，点击数量，发送API调用数详细统计数据一览无余。
提供简单接入的Rest API接口，方便开发者定制推送需求。
MobPush管理后台提供推送相关数据统计查询，包含新增用户数、推送数量、推送点击量、用户点击数、发送API调用次数等数据。还可多维度对数据进行筛选分析，有助于开发者实时监控并了解app整体趋势。

mobPushPlus 模块概述

mobPushPlus 封装了 MobPush，是对 APICloud 平台的支持，为APICloud开发的App提供推送功能的一个组件，支持当前主流的推送功能。

如有问题请联系技术支持:

模块使用攻略

开发者使用本模块之前需要先到申请开发者账号，并在账号内填写相应信息创建自己的 APP，从而获取AppKey和AppSecret,然后添加MobPush功能。
详情参考:快速集成获取apppkey和appSecret

使用此模块之前建议先配置文件，配置完毕，需通过云端编译生效，配置方法如下：

iOS配置：

1.配置config.xml文件

2. 配置info.plist文件 该文件含MOB平台MOBAppKey和MOBAppSecret、特殊平台appkey配置、白名单配置,将info.plist放在widget://res文件目录下，文件内容：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>MOBAppKey</key>
    <string>moba6b6c6d6</string>
    <key>MOBAppSecret</key>
    <string>b89d2427a3bc7ad1aea1e1e8c1d36bf3</string>
    <key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>
</dict>
</plist>

MOBAppKey、MOBAppSecret:（必须配置）从mob平台创建应用后，申请的app Key和app Secret.
配置ATS（App Transport Security），在info.plist文件中，APP可以使用http协议访问。配置方法参考iOS修改Info.plist之配置ATS.

Android配置：

Mob-AppKey/Mob-AppSecret的配置：这两个参数的配置在config.xml文件里，以meta-data标签的形式来配置，例如：

<meta-data name="Mob-AppKey" value="mob的appkey"/>
<meta-data name="Mob-AppSecret" value="mob的appSecret"/>

Android配置第三方平台的AppKey等信息遵循APICloud的惯例是在config.xml中配置。下面是配置各个平台信息的例子，实际的使用中需要开发者填写自己在第三方网站申请的值（只需要替换成对应的值，不需要替换name，否则将会读取不到）

<meta-data name="com.mob.push.xiaomi.appid" value="小米的appId" />
<meta-data name="com.mob.push.xiaomi.appkey" value="小米的appkey" />
<meta-data name="com.vivo.push.api_key" value="vivo的apiKey" />
<meta-data name="com.vivo.push.app_id" value="vivo的appId" />
<meta-data name="com.mob.push.oppo.appkey" value="oppo的appKey" />
<meta-data name="com.mob.push.oppo.appsecret" value="oppo的appsecret" />
<meta-data name="com.mob.push.meizu.appid" value="魅族的appId" />
<meta-data name="com.mob.push.meizu.appkey" value="魅族的appKey" />

MobPushPlus的android端需依赖mobtools模块，在模块库添加上。如果支持厂商推送，可从上下载对应厂商库并添加到自定义模块中进行使用。

引入模块

var pushApi = api.require('mobPushPlus');

设置 APNs 推送证书环境
setAPNsForProduction({params})

params

isPro：

类型：布尔
描述：iOS APNs 推送证书环境， true 生产环境，false 开发环境

示例代码

var pushApi = api.require('mobPushPlus');
pushApi.setAPNsForProduction({
    "isPro" : true
});

可用性

iOS系统

可提供的1.0.0及更高版本

addLocalNotification

添加本地通知
addLocalNotification({params})

params

localParams：

类型：集合
描述：本地通知定制参数

示例代码

var pushApi = api.require('mobPushPlus');
var localParams =  {
    "content" : "本地通知", // 通知内容
    "title" : "标题", // 通知标题
    "subTitle" : "副标题", // 通知副标题
    "timeStamp" : 1 ,// 1 秒后触发
    "badge": 2 ,// 角标，可以不传，不传Mob服务器统计自增
    "sound" : "voice.caf" // 文件要拖入项目，后缀名要加上，支持.caf .mp3 等结尾的铃声
};
pushApi.addLocalNotification({
    "localParams": localParams
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

addpushReceiver

接收通知的回调

addpushReceiver(callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{
    action: 1      //消息类型，0:自定义消息 1:收到消息 2:点击消息
    result:  // 消息的具体内容
    {
    }        
}

示例代码

var pushApi = api.require('mobPushPlus');
pushApi.addpushReceiver(function(ret, err){
    api.toast({
        msg: "收到消息",
    });
});

可用性

可提供的1.0.0及更高版本

getTags

获取标签
getTags(callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

示例代码

var pushApi = api.require('mobPushPlus');
pushApi.getTags(function(ret, err){
    var err_code = ret.errorCode; // 0 失败， 1 成功
    var tags = ret.tags;
    api.toast({
        msg: err_code ? "获取标签：" + tags + "成功" : "获取标签失败",
        location: 'middle'
    });
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

addTags

添加标签 addTags({params}, callback(ret, err))

params

tags：

类型：数组
描述：添加的标签组合

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{ 
        errorCode :  1
 }

示例代码

var pushApi = api.require('mobPushPlus');
var tags = ["tag1", "tag2"];
pushApi.addTags({
    "tags" : tags
}, function(ret, err){
    var err_code = ret.errorCode; // 0 失败， 1 成功
    api.toast({
        msg: err_code ? "添加标签："+ tags +"成功" : "添加标签失败",
        location: 'middle'
    });
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

deleteTags

删除指定标签 deleteTags({params}, callback(ret, err))

params

tags：

类型：数组
描述：删除的标签组合

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{ 
        errorCode :  1
 }

示例代码

var tags = ["tag1"];
var pushApi = api.require('mobPushPlus');
pushApi.deleteTags({
     "tags" : tags
}, function(ret, err){
    var err_code = ret.errorCode; // 0 失败， 1 成功
    api.toast({
        msg: err_code ? "删除标签：" + tags + "成功" : "删除标签失败",
        location: 'middle'
    });
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

清空所有标签 cleanTags(callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{ 
        errorCode :  1
 }

示例代码

var pushApi = api.require('mobPushPlus');
pushApi.cleanAllTags(function(ret, err){
    var err_code = ret.errorCode; // 0 失败， 1 成功
    api.toast({
        msg: err_code ? "清空所有标签成功" : "清空所有标签失败",
        location: 'middle'
    });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getRegistrationID

获取 RegistrationID getRegistrationID(callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

 { 
    regId: '02393ebsikk9'
 }

示例代码

var pushApi = api.require('mobPushPlus');
pushApi.getRegistrationID(function(ret, err){
    var regId = ret.regId; // reg有值成功，否则失败
    api.toast({
        msg: regId ? "获取regId："+ regId +"成功" : "获取regId失败",
        location: 'middle'
    });
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setAlias

设置别名 setAlias({params}, callback(ret, err))

params

类型：字符串
描述：别名字符串

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

示例代码


var alias = "小王";
pushApi.setAlias({
    "alias" : alias
},function(ret, err){
    var err_code = ret.errorCode; // 0 失败， 1 成功
    api.toast({
      msg: err_code ? "设置别名："+ alias +"成功" : "设置别名失败",
      location: 'middle'
    });
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

deleteAlias

删除别名 deleteAlias(callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{ 
    errorCode :  0
}

示例代码

var pushApi = api.require('mobPushPlus');
pushApi.deleteAlias(function(ret, err){
    var err_code = ret.errorCode; // 0 失败， 1 成功
    api.toast({
        msg: err_code ? "删除别名成功" : "删除别名失败",
        location: 'middle'
    });
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getAlias

获取别名 getAlias(callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{ 
    errorCode :  0
}

示例代码

var pushApi = api.require('mobPushPlus');
pushApi.getAlias(function(ret, err){
    var err_code = ret.errorCode; // 0 失败， 1 成功
    var alias = ret.alias;
    api.toast({
        msg: err_code ? "获取别名：" + alias + "成功" : "获取别名失败",
        location: 'middle'
    });
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

bindPhoneNum

绑定手机号 bindPhoneNum({params}, callback(ret, err))

params

phoneNum：

类型：字符串
描述：手机号字符串

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{ 
    errorCode :  0
}

示例代码

var pushApi = api.require('mobPushPlus');
var phoneNum = "110";
pushApi.bindPhoneNum({
    "phoneNum" : phoneNum
},function(ret, err){
    var err_code = ret.errorCode; // 0 失败， 1 成功
    api.toast({
        msg: err_code ? "绑定手机号："+ phoneNum + "成功" : "绑定手机号失败",
        location: 'middle'
    });
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

发送推送 sendMessage({params}, callback(ret, err))

params

msgType：

类型：数字
描述：消息类型: 1 apns, 2 自定义消息， 3 定时 apns

content：

类型：字符串
描述：模拟发送内容

space：

类型：数字
描述：定时消息时间（仅对定时消息有效，单位分钟，默认值为1）

extras：

类型：字典
描述：额外字段，用于自定义字段添加

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{ 
    errorCode :  0
}

示例代码

var pushApi = api.require('mobPushPlus');
pushApi.sendMessage({
    "msgType":  1, //消息类型: 1 apns, 2 自定义消息， 3 定时 apns
    "content": '远程推送', // 模拟发送内容
    "space":  2, // 定时消息时间（仅对定时消息有效，单位分钟，默认值为1）
    "extras": { } // 额外字段
},function(ret, err){
    var err_code = ret.errorCode; // 0 失败， 1 成功
    api.toast({
        msg: err_code ? "发送APNs成功" : "发送APNs失败",
        location: 'middle'
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

mobPushPlus

mobPushPlus

MobPush 功能

mobPushPlus 模块概述

模块使用攻略

iOS配置：

Android配置：

引入模块

params

示例代码

可用性

addLocalNotification

params

示例代码

可用性

addpushReceiver

callback(ret, err)

示例代码

可用性

getTags

callback(ret, err)

示例代码

可用性

addTags

params

callback(ret, err)

示例代码

可用性

deleteTags

params

callback(ret, err)

示例代码

可用性

callback(ret, err)

示例代码

可用性

getRegistrationID

callback(ret, err)

示例代码

可用性

setAlias

params

callback(ret, err)

示例代码

可用性

deleteAlias

callback(ret, err)

示例代码

可用性

getAlias

callback(ret, err)

示例代码

可用性

bindPhoneNum

params

callback(ret, err)

示例代码

可用性

params

callback(ret, err)

示例代码

可用性

GitHub