DCloud_App_Array
DCloud_App_Array
  • 发布:2019-02-25 20:25
  • 更新:5 天前
  • 阅读:72701

UniPush使用指南

分类:uni-app

从HBuilderX 2.0.3 起,uni-app、5+App、wap2app均支持UniPush。

概述

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

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

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

UniPush即降低了开发成本、又提高了push送达率,并且免费,是当前推送的最佳解决方案。

有了unipush,开发者不应该再使用其他push方案了。但我们发现很多开发者有误解,导致还在错误使用其他推送。

  • 常见误解1:“uniPush的专业性,和专业的个推、极光等服务可相比吗?”
    答:uniPush是由个推将其本来收费的vip push产品,免费提供给了DCloud的开发者。它与个推vip push的只有2个区别:1、免费;2、账户使用的是DCloud开发者账户,而无需再重新注册个推账户。个推是A股上市公司,专业性在推送领域领先。
  • 常见误解2:“uniPush好麻烦,我就喜欢个推、极光这种简单sdk,不想去各个rom厂商去申请一圈”
    答:有此误解的开发者,根本不知道推送行业的现状,不集成rom厂商的推送,就无法在App离线时发送push。你可以使用uniPush,然后只使用里面的个推服务,不去各个rom厂商申请推送,但你要知道这样做的后果就是在华为、小米、OPPO、VIVO、魅族上发不了离线消息。
  • 常见误解3:“uniPush的送达率还是不够,是否可以付费来提升送达率,个推是有付费提升送达率的方法的”
    答:前文已经说了。个推的付费提升送达率的产品就是vip push,而uniPush就是个推的vip Push。DCloud通过谈判免费给DCloud的开发者使用了。

UniPush推送服务由“个推”专为DCloud订制提供技术支持,因此在服务端的集成与“个推·消息推送”完全一致。对于之前使用个推的开发者,可以平滑的迁移到uniPush方案上。

整体架构

推送消息类型

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

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

  • 透传消息
    即自定义消息,UniPush推送服务只负责消息传递,不做任何处理,客户端在接收到透传消息后需要自己去处理消息的展示方式或后续动作。
    UniPush推送服务对透传消息的数据符合以下格式时做了特殊处理,将透传消息显示到系统通知栏

    {"title": "xxx","content": "xxx","payload": "xxx"}

第一步:开通UniPush推送服务

点此查看如何开通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":"测试内容","sound":"default","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);

注意:把$intent变量赋值字符串中的io.dcloud.HBuilder换成自己应用的包名
使用HBuilder标准真机运行基座下发推送消息https://demo.dcloud.net.cn/push/unipush.HBuilder/index.php
服务端对接推送服务PHP实例代码参考:https://github.com/dcloudio/H5P.Server/tree/master/push/UniPush


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

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

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

注意事项

推送通道选择逻辑

  • Android平台
    APP在线(个推推送通道可用)
    推送通知和透传消息都使用个推的推送通道下发推送消息。
    APP离线(个推推送通道不可用)
    推送通知,使用个推离线推送通道,离线消息会存储在消息离线库,离线时间内APP在线后下发推送消息。
    透传消息,如果符合厂商推送的厂商手机(配置了手机厂商推送参数并且在对应厂商的手机上),则使用厂商推送通道下发推送消息;否则使用个推的离线推送通道,离线消息会存储在消息离线库,离线时间内APP在线后下发推送消息。

  • iOS平台
    推送通知,uniPush后台管理界面中不支持下发此类型,个推提供的服务端API支持下发推送通知(设置APN参数则通过苹果的APNS通道,否则使用t个推通道)。
    透传消息,设置APN参数则通过苹果的APNS通道下发推送消息,没有设置APN参数则使用个推的推送通道下发。

华为厂商通道

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

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

VIVO厂商通道

注意事项:

  1. vivo对推送内容有要求:纯数字、纯英文、纯符号、”测试“字样、符号加数字,主要是这几类,正式应用不能发送这种消息。
  2. 支持vivo推送功能HBuilderX最低版2.1.0及以上.
  3. 不是全部vivo手机都支持消息推送,一些老手机不支持。具体请参考图中数据

其它厂商通道

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

其他相关资源

FAQ

Q:5+app和wap2app需要uniPush怎么办?
A:HBuilderX 2.0.3起,5+app和wap2app也支持了uniPush。
5+app和wap2app升级uniPush不需要改动app前端代码,只需要在HBuilderX中打开manifest.json的“SDK配置”页,在“推送”下勾选“DCloud UniPush”,并点击“配置”,在后台开通unipush服务,配置好厂商推送参数重新提交云端打包即可。后端服务器需要参考第二步对接个推推送服务。

Q:离线打包如何配置?
A:Android平台本地离线参考https://ask.dcloud.net.cn/article/36423

18 关注 分享
163828@qq.com Trust AJXMJC weliff@163.com DCloud_UNI_HDX 小诺小言 306816224@qq.com iyunxi@qq.com 今天回复我了吗 s710464107@gm.ntpu.edu.tw 1750352431@qq.com sam0912@sina.cn 1017981699@qq.com qfxiongbin@163.com 8925683@qq.com 2923767349@qq.com 2958248265@qq.com 康林

要回复文章请先登录注册

purpledong@qq.com

purpledong@qq.com

现在component里的activity要加"Activity"
```component=com.chinasofti.uniappPush/io.dcloud.PandoraEntryActivity```
5 天前
17826616659@163.com

17826616659@163.com

回复 1628664024@qq.com:
请问你解决了吗?
2019-11-27 17:28
小权

小权

华为NOVA5Z 离线后收不到推送。华为移动服务最新版,删除数据什么的做了,没用
2019-11-26 22:44
mingyong.g@foxmail.com

mingyong.g@foxmail.com

unipush是仅针对APP吗?
2019-11-22 15:15
轩LOVE青

轩LOVE青

服务端推送消息的地址是?
2019-11-22 14:12
a822193948@163.com

a822193948@163.com

回复 511206878@qq.com:
安卓的离线通知怎么弄得..可以分享一下吗
2019-11-20 18:29
yueyabai123@126.com

yueyabai123@126.com

回复 leejian:
好的 谢谢
2019-11-19 18:03
1554290199@qq.com

1554290199@qq.com

uni-app的推送服务端文档在哪里啊,个推的客服说他们的文档不适用uni-app
2019-11-19 16:04
leejian

leejian

回复 1229294194@qq.com:
分享一下华为厂商通道的调试经验呗。
2019-11-19 12:34
leejian

leejian

回复 731549985@qq.com:
我也是华为的离线通道无法成功。
2019-11-19 12:32