阅读指引:本文按照的思路进行整理,请按照您遇到问题的环节进行查找,或直接使用快捷键“Ctrl+F”搜索本文档。
Top问题:
如何开通推送服务权益?
打开服务开关和配置推送服务参数,具体操作步骤请参见开通推送服务。
如何查看应用是否已经开通推送服务权益?
推送服务权益异常如何排查?
应用认领和应用转移对推送权益是否有影响?
未发布到华为应用市场的应用是否可以使用推送服务?
可以正常使用推送服务。建议您及时通过AppGallery Connect将应用上架到应用市场以获得更好的服务体验。
推送服务在非华为手机上的使用是否有限制?
有限制,非华为手机需安装HMS Core APK才能正常使用推送服务,但可能存在兼容性问题,建议您使用华为手机进行测试。
设备接收推送消息的条件?
受Android API的限制,海外低版本的华为手机和非华为手机推送只能在Android API level 21(Android 5.0)以上使用。
如何给海外的用户推送消息?
推送服务支持跨区域发送消息,但是跨区域消息下发性能会受到影响。建议您在用户聚集地部署服务器,减少跨区域消息发送。
终端设备上如何抓取日志?
首先在您的电脑上安装adb,请参见Android官方指导。
adb shell setprop log.tag.hwpush VERBOSE adb logcat -v threadtime 1> D:\hwpush.log
同时请您尽可能记录出现问题的设备型号、EMUI版本号、HMS Core(APK)版本号、集成的推送服务SDK版本号以及复现问题的步骤,以便技术人员可以更快的为您进行技术定位。
客户端V2、V3版本和服务端V2、V3版本相互间的兼容?
客户端V2、V3版本是指Push SDK的版本与HMS Core的版本。服务端V2、V3版本是指服务端提供的REST API版本,目前版本是V3版本,前向兼容V2版本。服务端V3版本提供了一些最新功能,需要端侧版本配套来完成,如果不升级端侧的版本新功能将无法使用,因此建议您尽快切换最新的版本。
开发者集成推送服务的应用升级SDK的版本(2.x升级至5.x)对之前打开过App的用户有什么影响?
| SDK升级后用户是否打开过App | 用户是否升级HMS Core(APK) | 影响 |
|---|---|---|
|
|
| 原老版本的Token失效,上报新版本的Token,可以收到消息 |
|
|
| 原老版本的token不变,依旧有效,可以收到消息 |
|
|
| 原老版本的Token失效,上报新版本的Token,可以收到消息 |
|
|
| 原老版本的token不变,依旧有效,可以收到消息 |
客户端获取的AAID是否需要及时清除?
AAID不需要及时清除。
推送服务是否强依赖华为帐号登录?
推送不依赖华为帐号,用户不登录华为帐号也能够接收推送消息。
推送服务是否支持推送语音消息?
暂不支持直接推送语音消息,您可以通过下发高优先级透传消息使您的应用自己转语音消息。
推送服务能否实现发送通知栏消息,当应用处于前台运行时不通过NC展示,通过某种方法将数据传递给应用?
支持,请参见前台应用的通知处理。
为什么有些消息呈现样式不一致?
从EMUI 10.0版本开始不同消息类型提醒方式和呈现样式上会有差异,具体请参见消息分类标准。
如何将展示的营销通知消息改为非营销通知消息?
从EMUI 10.0版本开始推送服务智能的将通知消息分为服务与通讯消息、资讯营销消息。若要修改通知消息类型,需要自分类权益申请。自分类权益生效后,应用的推送消息将根据message.android.category字段进行归类。
消息已经显示发送成功,但我的设备为什么收不到?
华为终端设备上请通过文件管理App搜索“push.log”和“NC.log”日志文件。
推送服务点击消息无法打开目标activity,如何解决?
推送服务是否支持消息撤回或消息覆盖?
当前不支持消息撤回。消息覆盖请参见通知栏消息覆盖展示。
在应用进程关闭的状态下,是否可以收到透传消息?
推送服务在推送次数和频率方面有什么限制?
推送次数限制:每天向某个设备上某个应用(非Token)发送消息数量不超过3000条,超过3000条进行限流(限流24小时后恢复)。
推送速率限制:华为推送服务对推送速度的分配,主要依据应用在华为终端上的月活和应用类型进行计算分配。
应用QPS=应用MAU × 应用类别权重 × 整体分配系数。
应用在华为终端上MAU查询路径:
应用类别:应用在应用市场上架时选择的应用二级分类,查询路径:。
应用类别权重列表:
| 分组名称 | 应用分类 | 权重系数 |
|---|---|---|
| IM类 | 社交通讯 | 5 |
| 金融类 | 金融理财 | 5 |
| 新闻类 | 新闻阅读 | 4 |
| 内容类 | 图书阅读、影音娱乐、拍摄美化、休闲娱乐 | 3 |
| 电商类 | 购物比价 | 3 |
| 衣食住行类 | 便捷生活、出行导航、旅游住宿、美食 | 3 |
| 商务类 | 商务、汽车 | 3 |
| 游戏类 | 网络游戏、休闲益智、经营策略、棋牌桌游、体育竞速、角色扮演、动作射击 | 2 |
| 工具类 | 实用工具 | 1 |
| 运动健康类 | 医疗健康、运动健康 | 1 |
| 其他类 | 儿童、教育、主题个性 | 1 |
| 默认类 | Default(未上架) | 1 |
如何查询应用的QPS?
查询路径:
选择需要查看的应用,下方即可查到对应的QPS。

使用REST 接口单次推送消息数量是多少?
Push Kit服务器每次最多根据Token发送1000条消息。如果多于这个数字,需要开发者分批次发送。
推送消息的最大大小为4KB,这是否意味着给1000个Token推送消息将超过此限制?
消息体大小限制不包括Token。
发送测试消息是否会被频控?
为了方便开发者测试消息,在推送消息时可以设置target_user_type参数为1。每个应用每日可发送500条测试消息且不受每日单设备推送数量上限要求。
消息回执是什么功能?
消息回执是指Push Kit服务端将消息推送到用户终端之后,Push Kit端侧会给Push Kit服务端反馈送达结果,与此同时,Push Kit服务端会将消息送达状态以回执消息形式发送给您的应用回执服务端。
推送服务的回执状态码有哪些?
回执状态码详情请参见消息回执。
消息回执的出口IP是什么?
回执出口IP会变,不建议配置IP白名单,如果是出于安全考虑,建议配置回调用户名和回调秘钥进行身份验证。
您只需更换回执服务器上的证书,不需要登录AppGallery Connect网站做其他修改。
您需要更换回执服务器上的证书,并登录AppGallery Connect网站同步修改回执配置。此操作过程中回执服务不会中断。
修改回执配置操作:

为确保新旧证书替换过程中回执服务不中断,在更换回执服务器上的证书前,您需要先登录AppGallery Connect网站,将新证书设置为“备用证书”。
在30天内现有证书和备用证书均被回执服务信任,30天后若回执服务器已完成证书更换,回执服务将使用备用证书替换现有证书。
设置备用证书操作:
如何获取回执服务器证书的CA信息?
回执服务会保留证书的CA信息,通过校验证书的CA信息来确保回执消息正确发送到您配置的回执地址。
报表数据条目各字段是什么意思?
字段详情请参见推送报告。
报表数据中“未达消息详情 > 其他原因”主要是什么原因?
未达消息详情中的其他原因大多数情况是通知栏消息点击后无权限打开应用内页面下intentUri指向的activity。
解决方案:
推送服务的错误码有哪些?
推送服务有客户端错误码和服务端错误码两部分,还记录了开发者们在集成推送服务中遇到的常见错误码,如果这些错误码都不能解决您的问题,请联系技术支持描述问题,相关技术支持人员会及时处理您的问题。
Token是否有有效期?
Token没有有效期,但在某些场景中会发生变化,详情请参见Token场景介绍。
推送服务是否支持多渠道多包名打包?
支持多渠道打包,详情请参见多渠道配置。
推送服务是否支持个性化提示音?
支持,详情请参见自定义铃声。
调用下行消息显示敏感词内容导致推送失败,如何解决?
请参见基于第三方审核结果的消息推送进行检测。
开发者如何判断设备是否安装了HMS Core?
请参见HMS公共方法判断。
具体操作请参见Android官方指导。
在Android 11上,已安装HMS Core(APK)最新版本,仍然提示升级,如何解决?
Android 11更改了应用查询用户在设备上已安装的其他应用以及与之交互的方式。您应用的“targetSdkVersion”是30或者更高版本,并且集成的Push Kit 6.1.0.300之前版本时,将无法访问HMS Core(APK),并且持续提示升级。
您可以通过以下两种方法解决。
升级Push Kit的SDK至6.1.0.300及以上版本,版本信息请参见版本更新说明。
如果不升级SDK,需要在“AndroidManifest.xml”中manifest下添加<queries>标签。
<manifest ...>
...
<queries>
<intent>
<action android:name="com.huawei.hms.core.aidlservice" />
</intent>
</queries>
...
</manifest>
<queries>标签对工具的要求如下:
当前对您开放的特殊权限申请范围如下:
| 权限名称 | 功能描述 | 申请条件 |
|---|---|---|
| 透传消息到达用户设备后,直接唤醒应用。 |
| |
| 语音播报Beta | 消息到达后,唤醒应用执行语音播报动作。 | 有商家订单状态变化、商家物流状态变化、商家收款场景、医疗紧急提醒类场景的应用。 |
申请指导:
请提供如下信息到hwpush@huawei.com进行申请,我们会在15个工作日内回复申请结果,请您留意邮箱消息。
邮件主题:【特殊权益申请】 - 应用名称
邮件正文:申请权限名称 应用名称 应用包名 AppID 使用场景 消息展示截图(展示需要特殊权限的通知消息截图,如VOIP电话界面等)
示例申请模板:
邮件主题:【特殊权益申请】 - Welink 邮件正文: 申请权限名称:高优先级透传消息 企业名称: 应用名称:Welink 应用包名:welink.huawei.com AppID:1****12 使用场景:Welink是企业内部沟通软件,提供语音通话功能,希望借助高优先级透传消息,实现语音通话功能。 应用下载二维码及测试帐号如下: 承诺信息: 1.(应用名称)的(权限名称)仅用于符合规定的场景中(具体场景)。 2.业务结束后,应用不再阻止系统休眠。 3.如有违反上述1、2的其他行为,同意华为Push侧将该权益收回。 备注: 附带对应的截图,要求如下: 申请权益为“高优先级透传消息”,需要附带VOIP通话界面截图。 申请权益为“语音播报”,需要附带语音消息通知展示截图。