自定义推送规则
多端登录场景下，如果用户希望当某些平台的账号在线时，部分其他平台上的账号不收到离线推送通知，可以通过自定义推送规则实现。
前提条件
在实现“自定义推送规则”功能之前，请确保：
- 已实现 多端登录.
实现流程
用户离线推送规则变化通知
如需用户自定义规则时收到通知，请重写 ZIMEventHandler 对象中的 onUserRuleUpdated 方法实现。
Untitled
// 监听用户自定义规则
@Override
void onUserRuleUpdated(ZIM * /*zim*/, const ZIMUserRule & userRule) {
// 离线推送规则
userRule.offlinePushRule;
}
1
设置离线推送规则
如需支持用户自定义推送规则时，开发者需要构造 ZIMUserOfflinePushRule，规定用户在哪些平台上在线（onlinePlatforms）时，哪些平台无需接收离线推送（notToReceiveOfflinePushPlatforms）。
调用 updateUserOfflinePushRule 接口，设置上述规则。
Untitled
// 设置离线推送规则
// 构造 ZIMUserOfflinePushRule
zim::ZIM::ZIMUserOfflinePushRule offlineRule;
// 当用户 win、MacOS、Linux 平台登录时
offlineRule.onlinePlatforms = {ZIM_PLATFORM_TYPE_WIN, ZIM_PLATFORM_TYPE_MACOS, ZIM_PLATFORM_TYPE_LINUX};
// 用户在 iPhoneOS、iPadOS、Android 上不收到离线推送
offlineRule.notToReceiveOfflinePushPlatforms = {ZIM_PLATFORM_TYPE_IPHONEOS, ZIM_PLATFORM_TYPE_IPADOS, ZIM_PLATFORM_TYPE_ANDROID};
// 调用 updateUserOfflinePushRule 方法
zim::ZIM::ZIM.getInstance()->updateUserOfflinePushRule(offlineRule, [](const zim::ZIM::ZIMUserOfflinePushRule& updatedOfflinePushRule, const zim::ZIM::ZIMError& errorInfo) {});
1
查询用户定义的推送规则
通过调用 querySelfUserInfo，即可在回调中的 selfUserInfo.userRule.offlinePushRule 获取当前用户自定义的离线推送规则。
Untitled
zim::ZIM::ZIM.getInstance()->querySelfUserInfo([](const zim::ZIM::ZIMSelfUserInfo& selfUserInfo, const zim::ZIM::ZIMError& errorInfo) {
selfUserInfo.userRule.offlinePushRule; // 当前用户定义的离线推送规则
});
1