uni-app和Node.js使用uni-push2.0实现通知栏消息推送功能

uniapp 提供了 unipush 统一推送服务,但是每次要推送消息的时候都要登陆 Dcloud 开发者后台，有点不方便，运营需要在我们的后台系统就可以完成操作。

离线推送

仅 APP 端支持，当应用被用户关闭，或者运行到后台时，手机厂商为了省电或释放内存，会终止 App 后台联网。

消息将通过不会离线的手机厂商通道，下发到手机系统推送服务模块；

此时客户端会自动创建通知栏消息，展示在系统消息中心（如图所示）但客户端监听不到消息内容；当用户点击通知栏消息后，会将 APP 唤醒此时 APP 才能监听到消息内容。

在线推送

当应用在线时，不会创建“通知栏消息”，此时客户端会立即监听到消息内容。

如果你希望当应用在线时，也通过“通知栏消息”来提醒用户；可以通过以下两种方式实现：

1.监听到消息内容后，根据业务需要自己判断是否要创建“通知栏消息”，需要就调用创建本地消息 API 手动创建通知栏消息。

2.服务端执行推送时，传递参数 ，客户端就会自动创建“通知栏消息”（此时你监听不到消息内容），当用户点击通知栏消息后，APP 才能监听到消息内容。

以上两种方案各有优劣，方案一更加灵活；比如：客服功能，客户端接收到聊天消息时，应用如果已经打开聊天对话页面，就直接将监听到的推送内容，渲染到页面。如果应用未打开聊天页，则调用 api 创建“通知栏消息”提醒用户；此时你还可以执行一些其他逻辑，比如将 tabBar 的消息中心加红点等。方案二比较简便，客户端无需额外编写代码，自动创建通知栏消息；但仅适用于不关心客户端行为就创建“通知栏消息”的场景，如广告营销内容的推送等。

通知栏消息

UniPush 推送服务定义好的推送样式、后续动作的推送方式，客户端接收到后显示在系统通知栏，用户点击通知栏消息启动 APP（激活到前台）。

透传消息

即自定义消息，UniPush 推送服务只负责消息传递，不做任何处理，客户端在接收到透传消息后需要自己去处理消息的展示方式或后续动作

UniPush 推送服务对透传消息的数据符合以下格式时做了特殊处理，即符合该格式的透传消息会自动显示到系统通知栏【需要确保 app 通知权限已打开】

• uni-push2.0 需要开发者开通 uniCloud。不管您的业务服务器是否使用 uniCloud，但专业推送服务器在 uniCloud 上。

1、打开 服务空间 点击按钮

2、服务空间新购 页面填写信息，点击按钮

3、在确认订单信息页面，点击按钮

4、开通成功后会跳转到服务空间列表页面

• 在这页面可以看到我们刚才创建的服务空间
• 刚创建成功时需要等待10分钟左右，当状态为正常后便可正常使用了

• 开通unipush需要填写 ，需要先创建证书，可以自定义证书，也可以使云端证书，这里我选择的是云端证书。
• 参考资料：关于 Android 证书

1、在中，点击

• 点击创建证书后会弹出提示框，点击

2、创建证书后 会显示 和 按钮

3、点击查看证书信息，如下图所示：

• 将证书详情里的 值复制出来备用

1、在 Dcloud 控制台，选择侧边栏，选择应用会来到，点击，点击按钮

2、在弹出的窗口中，填写，包名是默认生成的，开发者可以在->->中查看：

3、填写，将证书详情里的值复制过来。

4、填写 ，将证书详情里的值复制过来。

5、填写 ，将证书详情里的值复制过来。

6、填写完信息后，点击按钮

7、可以看见我们新增成功的信息，如下图所示：

• 参考资料：iOS 证书申请

1、在 Dcloud 控制台，选择侧边栏，选择应用会来到，点击，点击按钮

2、在弹出的窗口中，输入

3、填写完信息后，点击按钮

• 可以看见我们新增成功的信息，如下图所示：

• 注：【由于没有配置厂商通道所以此时我们的 app 只能在线接收消息。但 ios 不用，既然提到就多说一点，配置 ios 推送服务必然要配置 ios 推送证书，其实在制作 iOS 推送证书的时候可以直接制作一份发布环境的 Push 证书，因为该证书发布和开发环境都能用，何必做两份呢。

• 苹果推送不同于安卓，他自有一套推送，配置好证书，在线离线都能接收】

1、手机号验证

按照国家法律要求，所有提供云服务的公司在用户使用云服务时都需要验证手机号。

用户初次开通 uni-push 时，需要向个推同步手机号信息（DCloud 开发者无需再注册个推账户）。

2、进入Dcloud控制台，选择，选择，点击

应用开通 UniPush 功能时，需要提交应用相关信息，如下图所示：

注意：UniPush 在申请开通时，需要确保输入的 Android 包名或 iOS Bundle ID 必须与打包时配置的一致，否则可能会导致无法收到推送消息。

• APPID:

  默认生成的，每个 uniapp 应用都会有一个 APPID，开发者可以在 配置文件->中查看。

• 应用名称:

  默认是你创建项目时的名称，如果需要修改，可以在直接修改，或者 配置文件->中修改。

• 选择平台:

  选择你需要的平台，我这边是选择了：Web/小程序 Android iOS 平台

• Android 包名:

• Android 应用签名:

  选择了后会自动填写签名信息，无需手动填写。

• iOS BundleId:

• 关联服务空间：

  • 选择一个需要绑定的云服务空间，如果没有，会有一个去开通的按钮，点击去开通

• 填写完信息后，点击按钮，如下图所示：

• 开通完成后，后续仍可以在这里修改以上信息。

若未完成开通离线厂商推送，只有在 app 在线时才能收到消息

1、Android 多厂商开通：

个推与主流安卓厂商合作融合了厂商推送 SDK，在后台配置 “厂商推送设置” 、并云打包后，可以同时使用 “离线推送”，能提高在安卓厂商设备上的消息到达率。

目前华为、荣耀、魅族、oppo（测试环境）不要求上架应用商店；vivo 、小米、oppo（正式环境）必须上架应用商店后才可使用离线厂商推送。

2、iOS 推送证书生成：

iOS 支持的推送通知功能，从苹果开发者官网导出证书并配置在后台的 “厂商推送设置” 后，可以同时使用 “离线推送”，能提高在 iOS 设备上的消息到达率。
iOS 使用推送无需上架 Appstore

参数统一配置在下图所示位置，且云打包后 app 端才会生效：

如需离线推送的话，需要到Dcloud控制台，选择，选择，点击 将需要推送的厂商配置好

可查看 客户端 api 介绍

1、创建并配置 uniCloud 云开发环境

1.1、在项目根目录->选择->选择

• 这时会在控制台输出提示

1.2、关联云服务空间

• 在弹出框中，选择你刚刚创建的云服务空间，点击按钮

• 关联成功后

1.3、新建云函数

• 在文件夹中，点击

• 在弹出框中，输入，选择，点击按钮

1.4、管理公共模块或扩展库依赖

• 在弹出框中，选择统一推送服务，点击按钮

注意：扩展库依赖 3 张 opendb 表：,,。公测版 uniCloud，执行扩展库会自动创建。如果你使用的是 uniCloud 正式版需要自己在 uniCloud 的 web 控制台 创建这 3 张表。

示例如下：

1.5、编写推送云函数

• 在文件夹中，找到文件，编写云函数代码
• 云函数中调用uni-cloud-push扩展库的sendMessage方法，向客户端推送消息

1.6、上传并运行推送云函数

• 在文件夹中，点击

2、App、Web、微信小程序端配置

2.1、App模块配置

在 uniApp 项目 配置文件，选择，向下找到，勾选后，点击 下面的配置链接，即可进入 Uni Push 配置页面。如下图所示：

离线推送这边我是测试而已所以只选了华为、小米、OPPO、VIVO、百度、魅族、荣誉等，其它平台可以自行选择。

2.2、Web配置

2.3、微信小程序配置

• 其他小程序启用方式参考微信小程序，这里不一一列举

小程序中使用uni-push2.0的白名单配置

uni-push在web和小程序端就是个websocket；各家小程序平台，均要求在小程序管理后台配置小程序应用的联网服务器域名，否则无法联网。

根据下表，在小程序管理后台设置socket合法域名。下表的域名均为个推自有域名，并非DCloud所属域名。

在n中配置完之后，需要重新编译项目，即：点击如图重新运行按钮

3、App.vue代码实现

3.1、检查是否开启了通知权限

微信小程序和App端需要进行权限检查，因为微信小程序和App端，默认没有开启通知权限，需要用户手动去开启。

我这边的代码只是做了app的权限检查，微信小程序的权限检查，可以参考官网

3.2、客户端获取 cid

假如我要给“张三”打电话，那就需要知道对方的电话标识，即电话号码是多少。 同理，要给某个客户端推送消息，也需要知道该设备的客户端推送标识。

3.3、监听消息推送

3.4、完整代码

4、打包自定义基座

• 点击菜单栏的【发行】-【原生APP-云打包】然后再弹出的窗口中勾选【制作自定义调试基座】- 点击【打包】

• 打包成功后，点击菜单栏的【运行】-【运行到手机或模拟器】-【运行到 Android App 基座】然后在弹出的窗口中勾选【使用自定义基座运行】-【运行】

5、APP端真机运行注意点

• 如果启用了离线推送，必须：经过发行原生app云打包后，客户端才能监听到推送消息。标准HBuilder运行基座无法使用。
• 离线推送时，Android手机厂商通道推送需设置消息渠道id，否则会被限制频次和静默推送(静音且需下拉系统通知栏才可见)
• 如果Android应用进入后台后（App未销毁），点击通知消息无法拉起App，请检查设备是否有禁止后台弹出界面，路径>>设置-应用管理-测试应用-权限管理-后台弹出界面，(一般是小米、oppo、 vivo设备)。

1、云函数 URL 化

1.1、在服务空间列表中，点击服务空间名称，进入服务空间详情页

1.2、点击侧边栏 ->，进入云函数/云对象列表页，在列表中点击 按钮

1.3、设置URL的PATH部分

2、Node.js端代码实现

1、将app真机运行到手机后，在控制台可以看见输出的cid

2、在项目的pages/index/index.vue中编写测试代码

2.1、页面效果如下：

2.2、代码如下：

2.3 效果演示

• 点击发送消息按钮，看到消息推送成功后，在手机上通知栏可以看到推送的消息

uni-push 2.0 快速接入指南