技术FAQ

为什么打开应用能收到推送，杀死应用收不到推送？

• 如果您仅对接了极光自建通道，极光自建通道依赖APP长连接在线才能下发消息，长连接不在线时，消息会缓存到极光服务器，等到APP下次在线再下发，排查指引参考 离线无法收到推送。
• 如果您通过极光也对接了厂商通道，请检查厂商通道SDK是否集成成功，再通过极光控制台的排查工具说明 查询进行生命周期查询原因。
• 如果查询通知已经抵达设备但是没有展示，请参考 通知展示相关问题 文档进行展示排查。
• 如果上述排查后，仍未解决，请提供:appkey、msgid 和 regid 提供给到极光在线客服，或者您的专属技术支持，或者发邮箱到 support@jiguang.cn 协助。

为什么消息推送无法走厂商通道下发？

• 请检查厂商通道SDK是否集成成功
• 请检查您服务端的消息下发策略：消息下发时，通道选择是根据开发者推送时所选择的下发策略字段 distribution 取值来决定的，详情可参考推送 API 协议
• 请确认你是否开通极光VIP服务，极光非VIP客户，对于厂商通道下发量有管控，详细说明参考极光平台限制

如何获取 Appkey、regid、msgid？

详情参考 排查必要参数获取办法。

如何获取客户端日志？

如果集成有报错，需要获取客户端日志时，请按照 客户端日志获取方法 获取日志进行初步排查，若按照报错提示仍无法解决问题，可以提供日志给技术支持进行排查。

如何使用标签和别名推送消息？

详情参考 别名和标签使用指南 文档。

为什么标签、别名设置失败？

标签和别名有绑定时效和个数限制，详情参考 标签/别名设置相关问题 进行排查。

如何设置自定义铃声？

目前仅极光通道和部分厂商通道支持自定义铃声，详情参见 自定义铃声设置。

如何设置通知栏图片？

极光推送支持大图片、右侧图标、状态栏小图标设置，详情参见 图标设置。

厂商通道无法跳转？

1.请确认是否按照 Android 通知点击跳转 文档进行配置下发。

• 客户端完成 action 和 activity 等配置。
• 服务端按照 intent 固定格式进行下发。

2.若推送参数包含特殊字符：#、；等，需要对厂商的数据进行 encode 处理。在 notification.android.extras 字段下配置 third_url_encode 参数：

           "extras": {
           "third_url_encode": true    //true 表示需要极光encode处理
 }

 "extras": {
           "third_url_encode": false    //false，或者无此字段，表示不需要极光 encode 处理

        

推送返回 1011 ，并显示"cannot find user by this audience or has been inactive for more than 255 days"

1011 表示该推送没有满足条件的推送目标，具体排查参考 1011 错误码排查方法。

iOS 推送环境不匹配（errcode：-16）

排查工具查询消息生命周期显示“-16 iOS 推送环境不匹配”，说明注册 token 环境与推送选择的环境参数不匹配，详情参考 iOS 推送环境问题。