自定义推送规则

多端登录场景下，如果用户希望当某些平台的账号在线时，部分其他平台上的账号不收到离线推送通知，可以通过自定义推送规则实现。

前提条件

在实现“自定义推送规则”功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，获取到了接入 ZIM SDK 服务所需的 AppID 和 ServerSecret。ZIM 服务权限不是默认开启的，使用前，请先在 ZEGO 控制台 自助开通 ZIM 服务（详情请参考 项目管理 - 即时通讯），若无法开通 ZIM 服务，请联系 ZEGO 技术支持开通。
• 已获取登录 SDK 所需的 Token，详情请参考 使用 Token 鉴权。
• 已集成 ZIM SDK，详情请参考 快速开始 - 实现基本收发消息 的 “3 集成 SDK”。

• 已实现 多端登录。

实现流程

用户离线推送规则变化通知

如需用户自定义规则时收到通知，请重写 ZIMEventHnandler 对象中的 onUserRuleUpdated 方法实现。

// 监听用户自定义规则
ZIMEventHandler.onUserRuleUpdated = (ZIM zim, ZIMUserRule userRule){
    // 离线推送规则
    userRule.offlinePushRule;
};

设置离线推送规则

如需支持用户自定义推送规则时，开发者需要构造 ZIMUserOfflinePushRule，规定用户在哪些平台上在线（onlinePlatforms）时，哪些平台无需接收离线推送（notToReceiveOfflinePushPlatforms）。

调用 updateUserOfflinePushRule 接口，设置上述规则。

// 设置离线推送规则
try{

    ZIMUserOfflinePushRule rule = ZIMUserOfflinePushRule();
    // 当用户 win、MacOS、Linux 平台登录时
    rule.onlinePlatforms = [ZIMPlatformType.win,ZIMPlatformType.macOS, ZIMPlatformType.linux];
    // 用户在 iPhoneOS、iPadOS、Android 上不收到离线推送
    rule.notToReceiveOfflinePushPlatforms = [ZIMPlatformType.iPhoneOS, ZIMPlatformType.iPadOS, ZIMPlatformType.android];

    // 调用 updateUserOfflinePushRule 方法
    ZIMUserOfflinePushRuleUpdatedResult result = await ZIM.getInstance()!.updateUserOfflinePushRule(rule);

} on PlatformException catch (onError) {
    onError.code;
    onError.message;
}

查询用户定义的推送规则

通过调用 querySelfUserInfo，即可在回调中的 selfUserInfo.userRule.offlinePushRule 获取当前用户自定义的离线推送规则。

// 查询用户定义的推送规则 
try{
    ZIMSelfUserInfoQueriedResult result = await ZIM.getInstance()!.querySelfUserInfo();
    result.selfUserInfo.userFullInfo; // 当前用户的用户信息
    result.selfUserInfo.userRule.offlinePushRule; // 当前用户定义的离线推送规则

} on PlatformException catch (onError) {
    onError.code;
    onError.message;
}