ZIM 离线推送调试

2026-10-13

注意

本文档仅适用于调试 iOS 和 Android 设备（VIVO 设备暂不支持）。

概述

在您接入 ZIM 离线推送能力后，可通过控制台进行自助调试，校验“客户端 -> ZPNs 服务器 -> 厂商”链路是否正确，若哪一环节出错控制台会提示相关原因，方便您及时调整。

在控制台调试离线推送之前，请确保您的项目已接入 ZIM 离线推送功能并获取 PushID，详情请参考：

调试所需信息如下表所示：

字段	是否必填	说明
AppID	是	实现离线推送项目的 AppID。注意该项目需已配置离线推送证书，详情请参考离线推送配置
推送标题	是	离线推送消息的标题。
推送内容	是	离线推送消息的内容。
payload	否	自定义透传字段。
Push ID	是	设备唯一 ID。

输入上述信息后，即可点击 “开始调试”。ZEGO 控制台会检测链路是否正确，并返回相关信息。

注意

控制台发起的离线推送只要发送成功，客户端就能直接收到返回结果，没有额外的触发条件。通过 SDK 向 ZIM 服务端发起的离线推送，需要满足特定条件才能触发，具体触发条件请参考移动端后台状态、不同状态对长连接的影响，以及不同状态下如何获得推送通知展示。

如果调试成功，测试设备会收到离线推送。若调试失败，您可根据返回的错误信息进行自助排查。若您无法自助排查，请联系 ZEGO 技术支持。

说明

针对不同类型的 App，各手机厂商可能会有推送测试限额，具体请咨询相关手机厂商。