flymePush

立即使用

register unRegister subScribeTags unSubScribeTags unSubScribeAllTags checkSubScribeTags subScribeAlias unSubScribeAlias checkSubScribeAlias getPushId clearNotification clearByNotifyId setMsgArrivedListener setNotifyClickListener

概述

魅族推送服务是由魅族公司为开发者提供的消息推送服务,开发者可以向集成了flymePush的 客户端实时地推送通知或者消息,与用户保持互动,提高活跃率。

使用前说明

  • 在使用flymePush之前需要到 魅族开放平台 后台创建应用并获取 appkey & appSecret & appId

使用此模块之前需先配置 config.xml 文件,如下

  1. <feature name="flymePush">
  2. <param name="appId" value="*****" />
  3. <param name="appKey" value="*****" />
  4. </feature>

接口

register

订阅

register(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常开启
  3. pushId:, //数字类型;注册id
  4. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.register(
  3. function(ret) {
  4. alert(JSON.stringify(ret));
  5. });

可用性

Android系统

可提供的1.0.0及更高版本

unRegister

取消订阅

unRegister(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;取消订阅是否成功
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.unRegister(
  3. function(ret) {
  4. alert(JSON.stringify(ret));
  5. });

可用性

Android系统

可提供的1.0.0及更高版本

subScribeTags

标签订阅

subScribeTags(callback(ret))

param

pushId

  • 类型:字符串类型
  • 描述:成功订阅的pushId

tags

  • 类型:字符串类型
  • 描述:标签

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. tags:[ //Json数组类型;标签列表
  4. {
  5. tagId:, //数字类型;标签id
  6. tagName:'', //字符串类型;标签名称
  7. }
  8. ]
  9. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.subScribeTags({
  3. pushId:'',
  4. tags:''
  5. }, function(ret) {
  6. alert(JSON.stringify(ret));
  7. });

可用性

Android系统

可提供的1.0.0及更高版本

unSubScribeTags

取消标签订阅

unSubScribeTags(callback(ret))

param

pushId

  • 类型:字符串类型
  • 描述:成功订阅的pushId

tags

  • 类型:字符串类型
  • 描述:标签

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. tags:[ //Json数组类型;标签列表
  4. {
  5. tagId:, //数字类型;标签id
  6. tagName:'', //字符串类型;标签名称
  7. }
  8. ]
  9. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.unSubScribeTags({
  3. pushId:'',
  4. tags:''
  5. }, function(ret) {
  6. alert(JSON.stringify(ret));
  7. });

可用性

Android系统

可提供的1.0.0及更高版本

unSubScribeAllTags

取消所有标签订阅

unSubScribeAllTags(callback(ret))

param

pushId

  • 类型:字符串类型
  • 描述:成功订阅的pushId

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. tags:[ //Json数组类型;标签列表
  4. {
  5. tagId:, //数字类型;标签id
  6. tagName:'', //字符串类型;标签名称
  7. }
  8. ]
  9. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.unSubScribeAllTags({
  3. pushId:'',
  4. }, function(ret) {
  5. alert(JSON.stringify(ret));
  6. });

可用性

Android系统

可提供的1.0.0及更高版本

checkSubScribeTags

获取所有标签

checkSubScribeTags(callback(ret))

param

pushId

  • 类型:字符串类型
  • 描述:成功订阅的pushId

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. tags:[ //Json数组类型;标签列表
  4. {
  5. tagId:, //数字类型;标签id
  6. tagName:'', //字符串类型;标签名称
  7. }
  8. ]
  9. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.checkSubScribeTags({
  3. pushId:'',
  4. }, function(ret) {
  5. alert(JSON.stringify(ret));
  6. });

可用性

Android系统

可提供的1.0.0及更高版本

subScribeAlias

别名订阅

subScribeAlias(callback(ret))

param

pushId

  • 类型:字符串类型
  • 描述:成功订阅的pushId

alias

  • 类型:字符串类型
  • 描述:别名

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. alias:‘’ //字符串类型;别名列表
  4. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.subScribeAlias({
  3. pushId:'',
  4. alias:'',
  5. }, function(ret) {
  6. alert(JSON.stringify(ret));
  7. });

可用性

Android系统

可提供的1.0.0及更高版本

unSubScribeAlias

取消别名订阅

unSubScribeAlias(callback(ret))

param

pushId

  • 类型:字符串类型
  • 描述:成功订阅的pushId

alias

  • 类型:字符串类型
  • 描述:别名

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. alias:‘’ //字符串类型;别名列表
  4. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.unSubScribeAlias({
  3. pushId:'',
  4. alias:'',
  5. }, function(ret) {
  6. alert(JSON.stringify(ret));
  7. });

可用性

Android系统

可提供的1.0.0及更高版本

checkSubScribeAlias

获取别名

checkSubScribeAlias(callback(ret))

param

pushId

  • 类型:字符串类型
  • 描述:成功订阅的pushId

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. alias:‘’ //字符串类型;别名列表
  4. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.checkSubScribeAlias({
  3. pushId:'',
  4. }, function(ret) {
  5. alert(JSON.stringify(ret));
  6. });

可用性

Android系统

可提供的1.0.0及更高版本

getPushId

获取已订阅pushId

getPushId(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. pushId:‘’ //字符串类型;已订阅pushId
  4. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.getPushId({
  3. }, function(ret) {
  4. alert(JSON.stringify(ret));
  5. });

可用性

Android系统

可提供的1.0.0及更高版本

clearNotification

清除所有通知栏消息

clearNotification(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.clearNotification({
  3. }, function(ret) {
  4. alert(JSON.stringify(ret));
  5. });

可用性

Android系统

可提供的1.0.0及更高版本

clearByNotifyId

清除所有通知栏消息

clearByNotifyId(callback(ret))

param

notifyId

  • 类型:数字类型
  • 描述:通知栏展示通知id

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.clearByNotifyId({
  3. }, function(ret) {
  4. alert(JSON.stringify(ret));
  5. });

可用性

Android系统

可提供的1.0.0及更高版本

clearByNotifyId

清除所有通知栏消息

clearByNotifyId(callback(ret))

param

notifyId

  • 类型:数字类型
  • 描述:通知栏展示通知id

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.clearByNotifyId({
  3. }, function(ret) {
  4. alert(JSON.stringify(ret));
  5. });

可用性

Android系统

可提供的1.0.0及更高版本

setMsgArrivedListener

清除所有通知栏消息

setMsgArrivedListener(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. message:{ //Json对象类型;收到消息
  4. content:'', //字符串类型;消息内容
  5. notifyId:, //数字类型;消息接收
  6. title:'', //字符串类型;消息title
  7. pushType:, //数字类型;消息类型
  8. taskId:,'' //字符串类型;taskId
  9. selfDefineContentString:'', //字符串类型;
  10. }
  11. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.setMsgArrivedListener({
  3. }, function(ret) {
  4. alert(JSON.stringify(ret));
  5. });

可用性

Android系统

可提供的1.0.0及更高版本

setMsgArrivedListener

设置消息接收监听

setMsgArrivedListener(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. message:{ //Json对象类型;收到消息
  4. content:'', //字符串类型;消息内容
  5. notifyId:, //数字类型;消息接收
  6. title:'', //字符串类型;消息title
  7. pushType:, //数字类型;消息类型,0:通知栏消息 1:透传消息。
  8. taskId:,'' //字符串类型;taskId
  9. selfDefineContentString:'', //字符串类型;
  10. }
  11. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.setMsgArrivedListener({
  3. }, function(ret) {
  4. alert(JSON.stringify(ret));
  5. });

可用性

Android系统

可提供的1.0.0及更高版本

setNotifyClickListener

设置通知栏消息点击监听

setNotifyClickListener(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status:true //布尔类型;是否正常返回
  3. message:{ //Json对象类型;收到消息
  4. content:'', //字符串类型;消息内容
  5. notifyId:, //数字类型;消息接收
  6. title:'', //字符串类型;消息title
  7. pushType:, //数字类型;消息类型,0:通知栏消息 1:透传消息。
  8. taskId:,'' //字符串类型;taskId
  9. selfDefineContentString:'', //字符串类型;
  10. }
  11. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. msg:'', //数字类型;错误信息 ret.status 为false时返回
  3. }

示例代码

  1. var flymePush = api.require('flymePush');
  2. flymePush.setNotifyClickListener({
  3. }, function(ret) {
  4. alert(JSON.stringify(ret));
  5. });

可用性

Android系统

可提供的1.0.0及更高版本