推送

接口声明

  1. { "name": "service.push" }

导入模块

  1. import push from '@service.push' const push = require('@service.push')

接口定义

push.getProvider()1000+

获取服务提供商。

参数:

返回值:

字符串,服务提供商的代号,如厂商的英文品牌名称,假如无此服务则返回空字符串

示例:

  1. console.log(push.getProvider())

push.subscribe(OBJECT)

订阅 push,后续可以收到 push 消息(一般可在应用初始化的地方进行调用。比如在 app 的 onCreate 方法中调用。)

参数:

参数名类型必填说明
successFunction成功回调
failFunction失败回调,返回失败原因
completeFunction执行结束后的回调
success 返回值:
参数名类型说明
regIdStringPushService 返回的注册 id,可用于针对某个用户发送消息

示例:

  1. push.subscribe({
  2. success: function(data) {
  3. console.log(
  4. `push.subscribe succeeded, result data = ${JSON.stringify(data)}`
  5. )
  6. },
  7. fail: function(data, code) {
  8. console.log(
  9. `push.subscribe failed, result data = ${JSON.stringify(
  10. data
  11. )}, code = ${code}`
  12. )
  13. },
  14. complete: function() {
  15. console.log('push.subscribe completed')
  16. }
  17. })

push.unsubscribe(OBJECT)

取消订阅(一般不建议调用,调用后 regId 失效,需要重新订阅获取新的 regId)

参数:

参数名类型必填说明
successFunction成功回调
failFunction失败回调,返回失败原因
completeFunction执行结束后的回调

示例:

  1. push.unsubscribe({
  2. success: function(data) {
  3. console.log(
  4. `push.unsubscribe succeeded, result data = ${JSON.stringify(data)}`
  5. )
  6. },
  7. fail: function(data, code) {
  8. console.log(
  9. `push.unsubscribe failed, result data = ${JSON.stringify(
  10. data
  11. )}, code = ${code}`
  12. )
  13. },
  14. complete: function() {
  15. console.log('push.unsubscribe completed')
  16. }
  17. })

push.on(OBJECT)

添加 push 事件回调(透传消息的 payload 内容可在此回调中收到)

参数:

参数名类型必填说明
callbackFunctionpush 事件回调处理
callback 返回值:
参数名类型说明
messageIdString消息 id
dataString消息内容 payload

示例:

  1. push.on({
  2. callback: function(ret) {
  3. console.log(`received pass through message, ret = ${JSON.stringify(ret)}`)
  4. }
  5. })

push.off(OBJECT)

移除 push 事件回调,push.on中的callback不会再收到透传内容

参数:

示例:

  1. push.off()

后台运行限制

无限制。 后台运行详细用法参见后台运行 脚本

支持明细

厂商支持备注
小米YES小米消息推送服务
中兴no-
华为1020+华为开发者联盟
金立1010+金立快应用开发者中心
联想no-
魅族1010+魅族集成推送服务
努比亚no-
OPPOYESOPPO 消息推送服务
vivono-
一加--
预览版no预览版不提供推送接口