UniPush使用指南 / 开普饭

从HBuilderX 1.7.2起，uni-app支持UniPush。
从HBuilderX 2.0.3 alpha起，5+App支持UniPush。

注意

uniPush的客户端jsapi不是uni.push，而是plus.push，详见https://www.html5plus.org/doc/zh_cn/push.html。
uniPush推送功能需提交云端打包后才能生效，如需真机运行生效请使用自定义基座

概述

UniPush是DCloud推出的集成型统一推送服务，内建了苹果、华为、小米、OPPO、魅族等手机厂商的系统级推送和个推等第三方推送。

国内Android的Push是一个混乱的世界，因为google的push服务器被墙，所以一些国内的安卓手机厂商各自做了自己的推送，比如华为小米魅族等，但还有很多国产手机厂商没有提供官方推送方案。三方独立公司如个推，则提供了独立的push方案。
在没有unipush以前，如果只使用三方push，会在很多国产手机上因为节电设置而无法保活push进程，导致无法推送。比如小米手机对三方推送封杀的比较厉害，App退出后很难成功发送push。
而如果每个安卓手机的官方push都集成一遍，这么多平台，工作量会非常巨大，管理维护也很麻烦。

uniPush解决了这个难题，开发者只需要开发一次。系统会自动在不同手机上选择最可靠的推送通道发送push消息，保障送达率。

UniPush即降低了开发成本、又提高了push送达率，并且免费，是当前推送的最佳解决方案。有个unipush，开发者不应该再使用其他push方案了，其他方案都达不到unipush的效果。

UniPush推送服务由“个推”专为DCloud订制提供技术支持，因此在服务端的集成与“个推·消息推送”完全一致。对于之前使用个推的开发者，可以平滑的迁移到uniPush方案上。
注意：UniPush推送服务必须重新向DCloud申请开通账户。

整体架构

推送消息类型

通常推送消息分以下两种类型：

通知栏消息（推送通知）
UniPush推送服务定义好的推送样式、后续动作的推送方式，客户端接收到后显示在系统通知栏，用户点击通知栏消息启动APP（激活到前台）。
透传消息
即自定义消息，UniPush推送服务只负责消息传递，不做任何处理，客户端在接收到透传消息后需要自己去处理消息的展示方式或后续动作。
UniPush推送服务对透传消息的数据符合以下格式时做了特殊处理，将透传消息显示到系统通知栏

复制代码{'title': 'xxx','content': 'xxx','payload': 'xxx'}

第一步：开通UniPush推送服务

UniPush仅支持uni-app类型项目，其它类型项目暂不支持
点此查看如何开通UniPush推送服务

注意：开通UniPush后，需在后台配置“厂商推送设置”，否则可能在服务端下发推送消息界面中不会显示第三方厂商推送内容（如intent）

获取厂商推送设置信息请参考：厂商推送应用创建配置流程

第二步：服务端下发推送消息

使用厂商推送下发推送消息必须设置intent，并且intent须符合格式，否则用户点击推送消息会导致无法启动APP。intent数据格式如下：

复制代码intent:#Intent;action=android.intent.action.oppopush;launchFlags=0x14000000;component=io.dcloud.HBuilder/io.dcloud.PandoraEntry;S.UP-OL-SU=true;S.title=测试标题;S.content=测试内容;S.payload=test;end

其中io.dcloud.HBuilder为APP包名，需要替换为自己APP的包名；
S.title=的值为推送消息标题，对应5+ API中PushMessage对象的title属性值；
S.content=的值为推送消息内容，对应5+ API中PushMessage对象的content属性值；
S.payload=的值为推送消息的数据，对应5+ API中PushMessage对象的payload属性值；
launchFlags=0x14000000字段，解决接收多条通知后点击可能无法触发click事件的问题

通过开发者中心后台下发推送消息

登录DCloud开发者中心，在“我创建的应用”列表中选择应用，左侧选择“Uni Push”，打开消息推送页面。
使用厂商通道必须使用“透传消息”类型下发推送消息

通过服务端接口下发推送消息

服务端集成时首先需要获取AppId、AppKey、MasterSecret参数，登录DCloud开发者中心，在“Uni Push”下的“应用配置”页面中获取，如下图所示：

参考“个推·消息推送”的服务端快速集成文档http://docs.getui.com/

通过服务端接口下发推送消息使用厂商通道必须通过“透传消息”类型下发推送消息
以下是php语言创建消息示例代码：

复制代码

$payload = '{'title':'测试标题','content':'测试内容','payload':'test'}'; $intent = 'intent:#Intent;action=android.intent.action.oppopush;launchFlags=0x14000000;component=io.dcloud.HBuilder/io.dcloud.PandoraEntry;S.UP-OL-SU=true;S.title=测试标题;S.content=测试内容;S.payload=test;end'; $template = new IGtTransmissionTemplate();//使用透传消息模板 $template->set_appId(APPID);//应用appid $template->set_appkey(APPKEY);//应用appkey $template->set_transmissionType(2);//透传消息类型 $template->set_transmissionContent($payload);//消息内容 $notify = new IGtNotify(); $notify->set_title('测试标题'); $notify->set_content('测试内容'); $notify->set_intent($intent); $notify->set_type(NotifyInfo_type::_intent); $template->set3rdNotifyInfo($notify);

完整服务端厂商推送教程参考：

第三步：客户端处理推送消息

UniPush推送服务已经封装好iOS&Android平台的原生集成工作，开发者只需要调用JS代码处理推送消息的业务逻辑：

使用条件编译直接调用5+ Push接口，参考5+ APP推送开发指南
uni的客户端jsapi仍然是plus.push，之前使用plus.push开发的代码仍然可以使用。
uni-app应用中使用UniPush推送服务参考https://ask.dcloud.net.cn/article/35726

注意事项

推送通道选择逻辑

Android平台
APP在线（个推推送通道可用）
推送通知和透传消息都使用个推的推送通道下发推送消息。
APP离线（个推推送通道不可用）
推送通知，使用个推离线推送通道，离线消息会存储在消息离线库，离线时间内APP在线后下发推送消息。
透传消息，如果符合厂商推送的厂商手机（配置了手机厂商推送参数并且在对应厂商的手机上），则使用厂商推送通道下发推送消息；否则使用个推的离线推送通道，离线消息会存储在消息离线库，离线时间内APP在线后下发推送消息。
iOS平台
推送通知，不支持。
透传消息，设置APN参数则通过苹果的APNS通道下发推送消息，没有设置APN参数则使用个推的推送通道下发。

华为厂商通道

在华为手机上必须安装“华为移动服务”才能使用华为的厂商推送通道，首先确保手机上已经安装“华为移动服务”应用。
如果在华为手机应用退出后无法接收到推送消息，可尝试以下操作：

更新“华为移动服务”到最新版本；
进入手机“设置”，在[应用和通知]->[应用管理]->[华为移动服务]->[存储]页面选择“删除数据”。
重新启动应用，退出后再此下发推送消息。

其它厂商通道

如果应用在线可以接收到推送消息，离线时使用厂商通道无法接收到推送消息，可参考多厂商推送接入流程及注意事项文档（Android）
最后也可以咨询个推客服，企业QQ：3007288187，或者在ask中@getui_johny

UniPush使用指南

概述