目录

FAQ

阅读指引:本文按照“服务权益 > 接入服务 > 消息呈现 > 其他”的思路进行整理,请按照您遇到问题的环节进行查找,或直接使用快捷键“Ctrl+F”搜索本文档。

Top问题:

推送服务有什么使用限制?

服务端推送消息后,为什么客户端无法接收到?

推送服务报表统计数据怎么查看?

权益类问题

如何开通推送服务权益?

打开服务开关和配置推送服务参数,具体操作步骤请参见开通推送服务。

如何查看应用是否已经开通推送服务权益?

推送服务权益异常如何排查?

  1. 请先检查您的应用是否已经成功开通推送服务,重复开通权益会报错。
  2. 请检查您的应用是否已经在其他帐号中上传,如已上传,请到其他帐号中将应用删除或申请应用转移,详情请参见应用转移操作指南。
  3. 请检查您的项目下是否已经存在应用,如未存在,请正常创建添加应用后重新开通推送服务权益。已存在应用的情况下,开通推送服务提示“应用不存在”,请检查之前是否执行过同包名应用的应用认领、删除应用等操作,如有该类操作,请先关闭原始项目的推送服务权益后再开通当前项目的推送服务权益。
  4. 排除上述原因,若还不能解决,请提供您应用包名、应用APP ID、企业名称和帐号,通过在线工单系统与我们进行联系。

应用认领和应用转移对推送权益是否有影响?

未发布到华为应用市场的应用是否可以使用推送服务?

可以正常使用推送服务。建议您及时通过AppGallery Connect将应用上架到应用市场以获得更好的服务体验。

接入类问题

推送服务在非华为手机上的使用是否有限制?

有限制,非华为手机需安装HMS Core APK才能正常使用推送服务,但可能存在兼容性问题,建议您使用华为手机进行测试。

设备接收推送消息的条件?

  1. 设备:非华为手机需安装HMS Core APK(从您设备上的应用市场搜索下载),华为手机无特殊要求。
  2. 网络:手机处于联网且网络稳定的状态。
  3. EMUI版本:部分EMUI 4.0、4.1设备,EMUI 5.0及之后的设备。建议您使用EMUI 5.0以上设备。

受Android API的限制,海外低版本的华为手机和非华为手机推送只能在Android API level 21(Android 5.0)以上使用。

如何给海外的用户推送消息?

推送服务支持跨区域发送消息,但是跨区域消息下发性能会受到影响。建议您在用户聚集地部署服务器,减少跨区域消息发送。

为什么推送消息失败?

  1. 请检查您是否已获取Token,如果获取Token失败,请参见常见错误码查看获取Token失败原因。
  2. 如果您已获取Token且使用推送运营平台推送消息,您可以在推送运营平台测试推送消息。如果也推送失败则是Token存在问题,尝试重新获取Token。
  3. 如果您已获取Token且使用REST API推送消息,请检查HTTP响应以确定消息头和消息内容是否正确,详情请参见服务端API返回码进行排查。
  4. 您还可以通过Push自助分析功能,输入“requestId”和“token”查询消息具体发送情况。
  5. 排除上述原因仍无法定位问题,请尽可能提供消息对应的“requestid”、发送的token、发送消息的时间、应用包名、应用APP ID、设备SN号,通过在线工单系统与我们进行联系。

终端设备上如何抓取日志?

首先在您的电脑上安装adb,请参见Android官方指导。

  1. 使用adb连上手机后,分别执行下面命令:
    adb shell setprop log.tag.hwpush VERBOSE
    adb logcat -v threadtime 1> D:\hwpush.log
  2. 尝试复现您遇到的问题场景。
  3. 按快捷键“Ctrl+C”完成日志抓取。

同时请您尽可能记录出现问题的设备型号、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字段进行归类。

消息已经显示发送成功,但我的设备为什么收不到?

  1. 请确认您发送的是通知栏消息而不是透传消息。
  2. 请确认您发送的消息是否被归为资讯营销类消息,资讯类消息仅在下拉通知栏时才能看到,请下拉通知栏查看是否收到消息。
  3. 请确认单个应用收到的通知栏消息未超过上限(EMUI 10&11上限为24条,EMUI 9为49条),超过上限后新消息直接丢弃,需要手动点击或删除一条展示的消息。
  4. 通过Push自助分析功能查看消息发送情况。
  5. 排除上述原因仍不能解决请尽可能提供消息对应的“requestid”、发送的token、发送消息的时间、应用包名、应用APP ID、设备SN号以及终端设备上的日志文件,通过在线工单系统与我们进行联系。

    华为终端设备上请通过文件管理App搜索“push.log”和“NC.log”日志文件。

推送服务点击消息无法打开目标activity,如何解决?

  1. 请确认点击消息是否跳转到您自己的应用,您无权打开其他应用activity。
  2. 请检查目标activity是否存在且其“exported”属性为“true”,即目标activity要对外公开,并且无权限保护。
  3. 请检查跳转的URI是否正确,请参见自定义点击消息动作进行排查。
  4. 排除上述原因仍不能解决请通过在线工单系统与我们进行联系。

推送服务是否支持消息撤回或消息覆盖?

当前不支持消息撤回。消息覆盖请参见通知栏消息覆盖展示。

在应用进程关闭的状态下,是否可以收到透传消息?

消息管控类问题

推送服务在推送次数和频率方面有什么限制?

推送次数限制:每天向某个设备上某个应用(非Token)发送消息数量不超过3000条,超过3000条进行限流(限流24小时后恢复)。

推送速率限制:华为推送服务对推送速度的分配,主要依据应用在华为终端上的月活和应用类型进行计算分配。

应用QPS=应用MAU × 应用类别权重 × 整体分配系数。

  • QPS(Quantity per second):每秒推送消息条数。
  • MAU(Monthly Active User):月活跃用户人数。
  • 若您的应用通过QPS公式计算所得的值不足6000,将执行默认6000的QPS;同时,全网流量较高时,也会出现系统级流控(流控对应的状态码为HTTP 503)。
  • QPS计算规则只适用于中国大陆。

应用在华为终端上MAU查询路径:“华为开发者联盟 > 管理中心 > 应用服务 > AppGallery Connect > 开发与服务 > 推送服务 > 推送报告 > 推送用户详情 > 30日活跃用户数”

应用类别:应用在应用市场上架时选择的应用二级分类,查询路径:“华为开发者联盟 > 管理中心 > 应用服务 > AppGallery Connect > APP > 应用信息 > 应用分类 > 应用二级分类”。

应用类别权重列表:

分组名称

应用分类

权重系数

IM类

社交通讯

5

金融类

金融理财

5

新闻类

新闻阅读

4

内容类

图书阅读、影音娱乐、拍摄美化、休闲娱乐

3

电商类

购物比价

3

衣食住行类

便捷生活、出行导航、旅游住宿、美食

3

商务类

商务、汽车

3

游戏类

网络游戏、休闲益智、经营策略、棋牌桌游、体育竞速、角色扮演、动作射击

2

工具类

实用工具

1

运动健康类

医疗健康、运动健康

1

其他类

儿童、教育、主题个性

1

默认类

Default(未上架)

1

如何查询应用的QPS?

查询路径:“华为开发者联盟 > 管理中心>应用服务 > AppGallery Connect > 开发与服务 > 推送服务 > 配置 > 选择应用”

选择需要查看的应用,下方即可查到对应的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白名单,如果是出于安全考虑,建议配置回调用户名和回调秘钥进行身份验证。

如何更换回执服务器证书?

如何获取回执服务器证书的CA信息?

  • 若证书已安装到回执服务器且回执服务器可访问,您可以新建一个回执配置,输入回调地址后会显示当前证书的CA信息。
  • 若证书未安装到回执服务器,您可以从证书中获取CA信息。

回执服务会保留证书的CA信息,通过校验证书的CA信息来确保回执消息正确发送到您配置的回执地址。

消息报表类问题

推送服务报表统计数据怎么查看?

报表数据条目各字段是什么意思?

字段详情请参见推送报告。

报表数据中“未达消息详情 > 其他原因”主要是什么原因?

未达消息详情中的其他原因大多数情况是通知栏消息点击后无权限打开应用内页面下intentUri指向的activity。

解决方案:

  1. 点击消息拉起应用内页面,都是通过跨应用启动Activity的方式来实现,需要保证要拉起的目标Activity存在且其“exported”属性为“true”,即目标Activity要对外公开,并且目标Activity无权限保护。
  2. 请参见打开应用自定义页面生成正确的intent参数。

其它问题

推送服务的错误码有哪些?

推送服务有客户端错误码和服务端错误码两部分,还记录了开发者们在集成推送服务中遇到的常见错误码,如果这些错误码都不能解决您的问题,请联系技术支持描述问题,相关技术支持人员会及时处理您的问题。

Token是否有有效期?

Token没有有效期,但在某些场景中会发生变化,详情请参见Token场景介绍。

推送服务是否支持多渠道多包名打包?

支持多渠道打包,详情请参见多渠道配置。

推送服务是否支持个性化提示音?

支持,详情请参见自定义铃声。

调用下行消息显示敏感词内容导致推送失败,如何解决?

请参见基于第三方审核结果的消息推送进行检测。

开发者如何判断设备是否安装了HMS Core?

请参见HMS公共方法判断。

在Android 13设备上,应用的通知默认处于关闭状态,此时用户无法接收通知栏消息,应用如何进行适配?
  • 若应用的targetSdkVersion为33或更高版本,您的应用需要注册新的通知权限“POST_NOTIFICATIONS”,且动态申请该应用权限。
  • 若应用的targetSdkVersion为32或更低版本,请及时适配并且升级最新的Push SDK版本。

具体操作请参见Android官方指导。

在Android 11上,已安装HMS Core(APK)最新版本,仍然提示升级,如何解决?

Android 11更改了应用查询用户在设备上已安装的其他应用以及与之交互的方式。您应用的“targetSdkVersion”是30或者更高版本,并且集成的Push Kit 6.1.0.300之前版本时,将无法访问HMS Core(APK),并且持续提示升级。

您可以通过以下两种方法解决。

申请特殊权限

当前对您开放的特殊权限申请范围如下:

权限名称

功能描述

申请条件

高优先级透传消息Beta

透传消息到达用户设备后,直接唤醒应用。

  1. 具备VOIP电话功能场景的沟通类、告警类应用。
  2. 仅服务于自身企业或政府组织单位内部。
  3. 提供包含被服务主体盖章的证明函(无固定模板),证明该App申请此权限仅服务于该主体。

语音播报Beta

消息到达后,唤醒应用执行语音播报动作。

有商家订单状态变化、商家物流状态变化、商家收款场景、医疗紧急提醒类场景的应用。

  • 自2020年8月12日起,不再提供高级别通知栏消息功能(即横幅通知)。
  • 申请的语音播报权限只能实现唤醒应用的功能,语音播报功能需要开发者实现。

申请指导:

请提供如下信息到hwpush@huawei.com进行申请,我们会在15个工作日内回复申请结果,请您留意邮箱消息。

邮件主题:【特殊权益申请】 - 应用名称

邮件正文:申请权限名称 应用名称 应用包名 AppID 使用场景 消息展示截图(展示需要特殊权限的通知消息截图,如VOIP电话界面等)

示例申请模板:

邮件主题:【特殊权益申请】 - Welink
邮件正文:
申请权限名称:高优先级透传消息
企业名称:
应用名称:Welink
应用包名:welink.huawei.com
AppID:1****12
使用场景:Welink是企业内部沟通软件,提供语音通话功能,希望借助高优先级透传消息,实现语音通话功能。
应用下载二维码及测试帐号如下:

承诺信息:
1.(应用名称)的(权限名称)仅用于符合规定的场景中(具体场景)。
2.业务结束后,应用不再阻止系统休眠。
3.如有违反上述1、2的其他行为,同意华为Push侧将该权益收回。

备注:
附带对应的截图,要求如下:
申请权益为“高优先级透传消息”,需要附带VOIP通话界面截图。
申请权益为“语音播报”,需要附带语音消息通知展示截图。

如果您在申请过程中遇到任何问题,请发送邮件至hwpush@huawei.com与我们取得联系。