DCloud_App_Array
DCloud_App_Array
  • 发布:2019-02-25 20:25
  • 更新:23 小时前
  • 阅读:223310

UniPush使用指南

分类:uni-app

从HBuilderX 2.0.3 起,uni-app、5+App、wap2app均支持UniPush;
从HBuilderX2.7.10开始,支持谷歌FCM,参考:https://ask.dcloud.net.cn/article/37356

概述

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

国内Android的Push是一个混乱的世界,因为Google的Push服务FCM被墙,所以一些国内的安卓手机厂商各自做了自己的推送,比如华为、小米、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厂商去申请一圈”
    答:uniPush不建立在申请手机厂商授权的基础上,如果你不申请那些,使用起来和用普通的个推是一样的。但是要特别注意,推送行业的现状就是:不集成rom厂商的推送,就无法在App离线时发送push。。按照普通个推模式使用,后果就是在华为、小米、OPPO、VIVO、魅族上发不了离线消息。
  • 常见误解3:“uniPush的送达率还是不够,是否可以付费来提升送达率,个推是有付费提升送达率的方法的”
    答:前文已经说了。个推的付费提升送达率的产品就是vip push,而uniPush就是个推的vip Push。DCloud通过谈判免费给DCloud的开发者使用了。
  • 常见误解4:开通uniPush要实名认证,还得传身份证,开通普通个推不用这么麻烦。
    答:此问题之前曾存在,后来已经处理,保持和个推需要的身份信息相同,不再需要身份证。

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

整体架构

推送消息类型

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

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

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

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

第一步:开通UniPush推送服务

点此查看如何开通UniPush推送服务

Android平台支持厂商推送通道

注意:开通UniPush后,需在后台配置“厂商推送设置”,否则可能在服务端下发推送消息界面中不会显示第三方厂商(手机厂商)推送通知内容(如intent)

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

iOS平台配置推送证书

iOS平台需要使用到苹果的APNS,务必在后台正确配置苹果推送证书,参考:iOS推送证书配置

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


使用厂商推送下发推送消息必须设置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事件的问题

注意事项:

  • intent格式与个推的多厂商pdf文档中描述的不一样,以此格式为准
  • intent是为了兼容Android平台的数据,但为了保持兼容性,建议iOS平台也配置此数据
  • action=android.intent.action.oppopush为固定的数据,是兼容oppo设备的离线推送功能,不需要修改
  • component=io.dcloud.HBuilder/io.dcloud.PandoraEntry中的io.dcloud.HBuilder为应用的包名,与App云端打包界面设置的Android包名一致

通过开发者中心后台Web页面发送Push消息

登录DCloud开发者中心,在“我创建的应用”列表中选择应用,左侧选择“Uni Push”,打开消息推送页面。
tips 推送页面改版,详情了解开发者中心Unipush推送页面优化介绍
使用厂商通道必须使用“透传消息”类型下发推送消息

使用代码通过服务端接口推送消息

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

如果使用uniCloud开发服务器

已经有封装好的易用插件负责服务器端开发,见:https://ext.dcloud.net.cn/plugin?id=1680

如果使用传统服务器开发

参考“个推·消息推送”的服务端快速集成文档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平台

不同ROM接收推送消息对桌面图标的角标处理逻辑存在差别

  • 小米手机:角标自动加1 (MIUI11 以下)
  • 华为手机:可以设置,走厂家通道离线推送可在服务端设置。参考可插件链接:(https://ext.dcloud.net.cn/plugin?id=1680)[https://ext.dcloud.net.cn/plugin?id=1680]
  • vivo手机:不会自动加1,需调用5+ API plus.runtime.setBadgeNumber动态设置角标数字
  • oppo手机:角标自动展示,具体形态与rom相关,可能是红点或数字。(需要打开角标权限)

iOS平台

根据接收到的推送消息处理桌面图标的角标,在uniPush后台的“iOS配置”项中可配置badge参数对角标进行设置,可取值:

  • “+1”,表示当前角标+1;
  • “-1”,表示当前角标-1(角标>=0);
  • “3”,表示指定角标值,值必须>=0。

默认(不设置badge参数)则角标数字不变,也可以在应用运行期调用5+ API plus.runtime.setBadgeNumber动态设置角标数字

注意事项

推送通道选择逻辑

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

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

Android平台厂商通道

华为厂商通道

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

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

VIVO厂商通道

需要在VIVO应用商店上线才能申请VIVO的厂商推送
注意事项:

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

OPPO厂商通道

需要在OPPO应用商店上线才能申请OPPO的厂商推送

谷歌FCM通道

需Android手机已经安装GMS,且手机网络可以连通谷歌FCM推送服务器。
详细教程另见:https://ask.dcloud.net.cn/article/37356

其它厂商通道

如果应用在线可以接收到推送消息,离线时使用厂商通道无法接收到推送消息,可参考UniPush厂商通道常见问题https://ask.dcloud.net.cn/article/36611
最后也可以登录个推官网进行技术咨询

其他相关资源

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平台App离线打包-Push
iOS平台App离线打包-Push

Q:iOS平台如何实现应用启动后不立即弹出“发送通知”系统授权框
A:参考:https://ask.dcloud.net.cn/article/36955

31 关注 分享
163828@qq.com Trust AJXMJC DCloud_UNI_HDX 小诺小言 306816224@qq.com iyunxi@qq.com 今天回复我了吗 s710464107@gm.ntpu.edu.tw 1750352431@qq.com 猫咪的尾巴 1017981699@qq.com qfxiongbin@163.com 8925683@qq.com 2923767349@qq.com 2958248265@qq.com 康林 jingge_fu@163.com maozai 王屋山老峰 DCloud_UNI_WYQ miclefox@aliyun.com 610627597@qq.com Unlimited_S 1768053968@qq.com aliang888 634784720@qq.com 627721034@qq.com 博文浩荡 getcww DigitalYu

要回复文章请先登录注册

550372894@qq.com

550372894@qq.com

回复 784164118@qq.com :
大佬解决了吗
23 小时前
550372894@qq.com

550372894@qq.com

华为离线收到通知怎么设置角标
23 小时前
492262026@qq.com

492262026@qq.com

回复 2297760646@qq.com :
哥们最终你弄好了啊。我是小米能推,华为不行。
1 天前
492262026@qq.com

492262026@qq.com

回复 不老刘 :
兄弟,我也只有小米能用,华为怎么都搞不定。
1 天前
维

回复 2810689101@qq.com :
绑定alias,教程:http://dt2008.cn/archives/756.html
5 天前
2810689101@qq.com

2810689101@qq.com

如何推送给指定用户呀呀呀
2020-11-23 14:43
1300073071@qq.com

1300073071@qq.com

为什么安卓端可以接受透传,但是无法触发click呢
2020-11-20 18:22
2993277254@qq.com

2993277254@qq.com

安卓端:
配置了厂商通道,华为,魅族可以离线透传可以正常接受,
但是
小米就是接受不到离线消息,unipush管理页面排查故障时查询cid是否有token,查询是没有token,
可是

用小米官网的sdk测试,可以正常注册设备token,

请问怎么判断小米注册推送token是否成功?
2020-11-19 19:33
zoneL

zoneL

回复 550372894@qq.com :
web收到新消息的时候调用起安卓通知栏的方法
2020-11-18 11:37
人人畅享

人人畅享

回复 swmonk@qq.com :
同样遇到这个问题,后台web推送没问题。
java代码推,返回成功,但是手机就是收不到
2020-11-16 13:28