问题现象
使用Push Kit(推送服务)提供的接口推送消息,但是客户端没有消息提示。
- 预期效果:推送消息后,客户端能及时收到消息提示,例如出现消息弹框。
- 实际效果:推送消息后,客户端未收到消息提示,或者没有及时收到消息,未出现消息弹框。
定位过程
- 用户收到了消息:
- 检查是否是静默通知。
- 检查是否手动关闭了消息提醒方式。
- 用户未收到消息:
- 检查消息回执状态码是否为6,若为6则继续排查通知开关、Push SDK方法调用等问题。
- 检查Push token是否正确。
- 检查Authorization请求体是否错误。
- 检查是否推送后台消息场景。
- 检查设备是否离线。
- 检查应用是否被杀死,是否开启"自启动"和"后台活动"权限。
- 检查应用的"通知渠道(通知类别)开关"是否被关闭,该开关独立于应用级总开关。
- 检查应用或三方SDK是否调用过pushService.turnOffPush()方法,设置了不显示通知栏消息。
- 检查自分类权益是否已申请,是否开启状态。
- 检查是否受到消息频控。
- 检查配置文件是否配置错误。
分析结论
- 资讯营销类消息的通知方式是静默通知,仅在通知中心展示消息。
- 服务与通讯类消息的通知方式默认是锁屏、铃声、振动,用户手动关闭锁屏、铃声、振动,导致未收到提示。
- 消息推送参数配置错误、被频控等情况下会导致消息推送失败。
- 推送请求中未正确携带category字段或取值与已申请的自分类权益不匹配时,消息会被默认按MARKETING处理,根据通知消息推送数量管理规则限制单设备单应用下每个自然日,限制推送数量为2条或5条,可能因此触发营销消息频控。
- 应用被杀死后,若未开启"自启动"权限或系统限制了后台活动,系统不会主动将应用拉起,导致消息无法投递。
- 应用的"通知渠道(通知类别)开关"是独立于应用级总开关的子开关,若被关闭则端侧收不到推送消息。
- 应用或三方SDK调用pushService.turnOffPush()方法后,会设置不显示通知栏消息,端侧同样上报"通知栏开关关闭"回执。
常见FAQ
Q:使用Push Kit发送category=SUBSCRIPTION的消息,设备处于夜间息屏状态且已设置睡眠模式允许打扰,消息被凌晨管控缓存导致延迟收到,能否豁免管控或实现实时送达?
A:Push Kit夜间息屏消息管控是推送服务侧的平台级策略,管控时段为0:00~6:00,设备熄屏30分钟后触发,管控期间消息被云侧缓存,不下发到设备。设备端的"睡眠模式允许打扰"设置控制的是通知到达设备后的提醒方式(响铃、震动等),不影响Push Kit服务端的夜间管控决策,因此无法通过该设置豁免管控。当前仅category=VoIP和应用内通话消息可豁免夜间管控,category=SUBSCRIPTION不在豁免范围内。夜间0点到6点只能通过亮屏的方式触发消息下发,如持续息屏无法下发消息。