自定义点击跳转

说明

本文档仅适用于 FCM 以外的 Android 推送通道。

描述

通常，用户点击离线推送通知时，会跳转到应用首页。基于本功能，开发者可以自定义离线推送通知的点击跳转逻辑，比如用户在点击推送消息时，能够跳转到指定页面，从而提升用户体验和交互效率。

自定义前：
自定义后：

前提条件

在实现自定义点击跳转之前，请确保：

已集成 2.8.0 或以上版本的 ZPNs SDK，详情请参考实现离线推送。
已在控制台配置离线推送证书，详情请参考控制台文档服务配置 - 即时通讯 - 离线推送配置。

实现流程

开通功能

请联系 ZEGO 技术支持配置开启自定义点击跳转功能。

重写回调

请在自定义的 ZPNsMessageReceiver 广播类派生类中（请参考实现离线推送->使用 ZPNs SDK 注册离线推送功能的类似内容），重写 onNotificationClicked 方法，以便获取跳转目标页面的路径。

Untitled

protected void onNotificationClicked(Context context, ZPNsMessage message) {
    Log.e("MyZPNsReceiver", "onNotificationClicked message:" + message.toString());
    // 获取透传消息（即跳转目标页面的路径）
    // 与发送消息时传入的 ZIMPushConfig > payload 字段内容一致, 请参考 [实现离线推送 - 使用 ZIM SDK 实现离线推送功能](https://doc-zh.zego.im/zim-android/offline-push-notifications/implement-offline-push-notification#%E4%BD%BF%E7%94%A8-zim-sdk-%E5%AE%9E%E7%8E%B0%E7%A6%BB%E7%BA%BF%E6%8E%A8%E9%80%81%E5%8A%9F%E8%83%BD)。
    String payload = message.getPayload();
    // 您可以根据上述信息编写代码实现跳转
}

Copied!

配置透传字段

消息发送者在发送消息时，需要通过 ZIMPushConfig > payload 参数设置透传字段（例如需要跳转到的目标页面路径）。相关代码请参考实现离线推送 - 使用 ZIM SDK 实现离线推送功能章节。

触发回调

收到推送后，当用户点击该推送，ZPNs 将会回调 onNotificationClicked 事件，随即用户界面跳转至指定页面。