DCloud_云服务_Mal
DCloud_云服务_Mal
  • 发布:2019-03-21 11:25
  • 更新:2023-10-21 17:19
  • 阅读:180474

UniPush开通指南

分类:uni-app

产品说明

Uni Push 是 DCloud 推出的推送产品,适用于uni-app、5+app、wap2app云端打包后的App应用。下面介绍一下如何申请开通及使用。

申请开通 Uni Push

Uni Push 需要在 开发者中心 申请开通后,方可使用。在开通此业务之前需要先根据页面提示完成邮箱验证,已验证邮箱请忽略。

Tips: 目前只有应用所有者可以操作 Uni Push。应用协作者暂不支持。

在通过实名认证以后,有两个入口可以进入 Uni Push 配置页面:

  • 通过 HBuilderX 进入
  • 通过开发者中心进入

通过 HBuilderX 进入

打开 HBuilderX,双击项目中的 “manifest.json” 文件,选择“App 模块配置”,向下找到“Push(消息推送)”,勾选后,点击 “uniPush” 下面的配置链接,即可进入 Uni Push 配置页面。如下图所示:
HX开通示例

通过开发者中心进入

  1. 使用 HBuilder 账号登录 开发者中心 ,登录后会进入“我的应用”列表

  2. 在左侧菜单点击“uniPush”,然后选择 1.0或2.0,进入Uni Push 信息页,左上角显示为当前要操作的应用,点击可以切换应用。如下图所示:

开通 UniPush

用户首次使用 UniPush 功能时,需要向个推同步身份信息。已通过实名认证的用户,会直接将实名认证信息同步给个推。如下图所示:

未提交实名认证信息的用户,需要在页面中输入相关信息后提交,如下图所示:

应用开通 Uni Push 功能时,需要提交应用相关信息,如下图所示:
注意:在申请开通时,需要确保输入的 Android包名iOS Bundle ID 必须与打包时配置的一致,否则可能会导致无法收到推送消息。

  • Android平台:
    Android包名必须与HBuilderX中App云端打包时配置的Android包名一致;Android 应用签名必须填入打包时使用证书的SHA1指纹。
  • iOS平台
    iOS BundleId必须与HBuilderX中App云端打包时配置的Bundle ID(AppID)一致。

如果已经开通 Uni Push,会看到如下页面:

iOS推送证书配置

iOS 平台还需要在 “配置管理”-“应用配置” 页面上传推送证书
如何获取推送证书请参考个推官方文档教程 iOS证书配置指南

云端打包

应用开通 Uni Push 功能以后,只需要在 HBuilderX 中打开manifest.json,选择“App SDK配置”,向下找到推送功能配置,勾选 “DCloud UniPush” 即可。

厂商推送参数设置(可选,应用离线时可提高推送成功率)

Uni Push 集成并统一了各个手机厂商的系统级推送,目前支持魅族、OPPO、华为、小米、VIVO。如果需要使用厂商推送,需要先在各厂商开发者平台申请。
申请通过后厂商会提供推送的相关参数,需要将这些参数配置到 DCloud 开发者中心后台。
厂商参数配置页面如下图所示:

修改应用信息

修改应用基本信息

在此页面可以修改应用名称、应用的 Android 包名和签名信息、iOS 包名。

关闭UniPush

当应用不再使用 UniPush 时,可在此页面关闭该功能。

重置 MasterSecret

MasterSecret 是 Uni Push 服务端API鉴权码,用于验证调用合法性。在调用服务端API时需要提供。如果 MasterSecret 泄漏,会对业务安全产生重大影响,可以在此处进行重置操作。重置 MasterSecret 会导致当前使用的 MasterSecret 失效,在进行重置操作前,请确认重置操作是否会对生产环境产生影响。如果确实需要进行重置,建议在业务低峰时段操作。

使用推送

推送使用方法,参考文档 UniPush使用指南

11 关注 分享
mmt Trust 无言_25 sonicsunsky t***@qq.com lose0101 河南dev DigitalYu 1***@qq.com 3***@qq.com 旋转的刘艹艹

要回复文章请先登录注册

Gjd

Gjd

ios 证书现在在哪里配置啊
2021-02-26 09:47
1***@qq.com

1***@qq.com

回复 2***@qq.com :
你可能是没有配置SHA256
2021-02-02 16:54
阿撒托斯太昊

阿撒托斯太昊

获取设备信息的plus.push.getClientInfoAsync中获取报错{"code":-1,"message":"no push platform"}
plus.push.getClientInfo().clientid获取为"null"
请问是什么原因嘞?前几天都还可以获取到,连着手机也可以获取到,自定义基座和真是打包无法获取
2021-01-28 19:04
2***@qq.com

2***@qq.com

回复 3***@qq.com :
h5怎么可能有cid,手机才有
2021-01-04 16:54
2***@qq.com

2***@qq.com

华为离线并不能收到通知呢
2020-12-08 15:02
3***@qq.com

3***@qq.com

为什么,我在自定义基座原生里面能打印到cid但是在H5页面获取到的是空,我h5里面还延时去获取的,setTimeout(function(){
plus.push.getClientInfoAsync(function(info) {
uni.setStorageSync("pushId", info.clientid);

console.log("clientid:"+JSON.stringify(info));
}, function(e) {})

},10000)
2020-11-23 11:36
z***@163.com

z***@163.com

在app页面里面,如何监听到个推消息到手机了?
2020-10-24 17:41
1***@163.com

1***@163.com

回复 DCloud_云服务_Mal :
使用uni厂商推送华为的透传在线可以接收到,离线就接收不到了,是必须要APP上架之后才可以么?
2020-10-15 19:19
DCloud_云服务_Mal

DCloud_云服务_Mal (作者)

回复 m***@163.com :
可以。开通厂商推送接收离线概率高,不开厂商推送概率极低(推送通道会被系统关闭)
2020-09-28 19:02
m***@163.com

m***@163.com

自定义基座能接收离线推送吗
2020-09-28 18:19