更新记录

4.0.5（2021-09-01） 下载此版本

整理了schema代码格式，解决：上传数据集合Schema(msg.schema.json) schema内容格式不正确的报错

4.0.4（2021-09-01） 下载此版本

使用uni-config-center

4.0.3（2021-01-01） 下载此版本

新增微信小程序，订阅消息示例

平台兼容性

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

本插件已过期！仅为使用uni-push1.0的旧项目保留。新项目推荐使用更强大的新版uni-push2.0详情查看

说明： 虽然本插件为uniCloud版UniPush插件，但并不要求开发者把所有的后台服务都迁移到uniCloud。

• 支持：uniCloud 或传统（PHP、JAVA、PYTHON、C等）语言开发为后台的APP
• 如果您使用uniCloud为后台，只需要改个config配置就能直接使用了。若无uniCloud基础，请先看免费视频教程：uniCloud入门到精通
• 如果你的系统之前是非uniCloud写的可以将本插件url化为api进行调用访问；详情：云函数转url教程

开通uniCloud是免费的，其中阿里云是全免费，腾讯云是提供一个免费服务空间。

功能支持：

1. 离线厂家推送
2. 消息中心UI
3. 已读未读处理、本地与同步push服务端的角标处理
4. 支持苹果、小米、华为和部分oppo手机的厂家离线推送角标设置。

如果你还没开通UniPush你也许需要阅读一下： UniPush开通指南

什么是PUSH？

• 一种服务端向在线或者离线的客户端， 实时通信的技术。

PUSH现状:

• ios系统的苹果手机可以直接将push消息从开发者服务器发给苹果服务器，完美送达苹果手机。

• 而由于Google的Push服务FCM被墙，国内的应用不能通过FCM及时向用户发送消息。

• 第三方推送仅能在APP在线时接收，APP一旦被关闭（用户自己手动关闭，或手机的节电设置自动关闭了应用）就收不到消息了。

• 国内手机的厂家已经推出了能在应用处于离线状态也能收到push消息的服务。然而安卓手机的厂商多，国内就有5大手机厂商：华为、小米、vivo、oppo、魅族。这对于APP开发者来说每个手机厂家的服务都得集成开发一遍，这么多平台，工作量会非常巨大，管理维护也很麻烦。

国内有一家叫DCloud的公司，推出了UniPush解决了这个问题。

• 技术上：DCloud再uni（统一）了一下，推出UniPush，开发者只需要开发一次。系统会自动在不同手机上选择最可靠的推送通道发送push消息，保障送达率。
• 价格上：UniPush的底层是“个推”（A股上市公司），个推的产品vip版是收费的；而个推是DCloud的股东，之间达成战略：将原本收费的个推vip版推送服务，完全免费地开放给DCloud旗下产品开发者使用。 这比市面上同类产品有了根本上绝对的优势，也成为了开发者们选择uni-app的一个理由。

PUSH消息类型：

• 消息分在线和离线。在线分透传和非透传，离线只能接收非透传消息。前者好理解，什么是透传呢？以微信聊天为例，当你打开微信聊天界面时，你收到了好友给你发送消息。 而在你的手机消息通知栏没有通知。这就是一种透传的表现。当你把应用切到后台（无论这个时候APP进程是否被杀死） 如果你收到push消息，你的手机系统消息通知栏就会出现一条消息通知。你点击它一般就会唤醒app，或打开每个网页。这就是非透传消息通知。
• 那么透传消息能否也实现在手机消息中心创建通知呢？答案是肯定的，你可以在收到透传消息的时候根据自己的业务设计用5+ plus接口创建。

流程图：

注意这是原生支持端功能，必须使用正确的包名、证书、签名才能使用**

目录结构：

├── cloudfunctions          #云函数目录
|   │─── common             #公共模块
|   |   │── config          #配置文件
|   |   └── push            #push核心代码模块
│   └── pushDemo            #推送功能demo
└── 根目录

使用流程：

1. 开通并配置UniPush详情
2. 将获取到的相关key填写到配置文件
3. 通过自定义基座获取到某一台设备的clientid
4. 修改pushDemo文件的clientid右键上传并运行即可体验

实例：

 const push = require('push')
 await push(PushType,PushData)

PushType: ( String ) 必选 推送类型 插件支持两种推送方式

• 示例:

  return await push("toSingle",{
  "title"     : "【单推】31测通知栏标题（长度取最小集）限制 32 字",
  "content"   : "【单推】31测通知栏内容（长度取最小集） content 长度小于 80 字",
  "payload"   : JSON.stringify({data:"【单推】数据"}),
  "clientid"  : "1a342f5f085b493cda095cdfaa413556"
  //用户单clientid 来源 plus.push.getClientInfo()  http://www.html5plus.org/doc/zh_cn/push.html#plus.push.getClientInfo
  })

PushData: ( JSON ) 必选 事件类型 插件支持两种推送方式

• 示例:

  return await push("toApp",{
  "title"     : "【群推】测通知栏标题（长度取最小集）限制 32 字",
  "content"   : "【群推】31测通知栏内容（长度取最小集） content 长度小于 80 字",
  "payload"   : JSON.stringify({data:"【群推】数据"})
  })

注意：

1.请打包app【建议用自定义基座】2.务必使用真机调试

2.厂商推送应用创建配置流程

华为手机厂家离线推送为高频咨询，请注意：

华为厂商通道在华为手机上必须安装“华为移动服务”才能使用华为的厂商推送通道，首先确保手机上已经安装“华为移动服务”应用。 如果在华为手机应用退出后无法接收到推送消息，可尝试以下操作： 更新“华为移动服务”到最新版本； 进入手机“设置”，在[应用和通知]->[应用管理]->[华为移动服务]->[存储]页面选择“删除数据”。 重新启动应用，退出后再下发推送消息。

更多关于UniPush的文献参考：UniPush使用指南

有任何问题联系我qq群：935395389； 希望能高分， 如果大家支持，我将愿意更多地分享我司优秀插件于大家共享