浏览 SDKs · Flutter
平台
SDKsFlutter

设置全局消息接收方式

使用 Flutter SDK 设置当前账号的默认消息接收与通知方式。

复制

配置当前账号在所有单聊与群聊会话中的默认全局消息接收与离线推送策略:

参数说明

通过更新当前用户资料方法传入 globalRecvMsgOpt 字段,单独配置全局免打扰策略,避免与修改昵称或头像混淆:

参数类型是否必填说明
globalRecvMsgOptint是全局消息接收选项枚举值。通常在正常接收与免打扰之间切换。
枚举值数值含义
ReceiveMessageOpt.receive0正常接收消息,并允许离线推送或通知提醒。
ReceiveMessageOpt.notNotify2接收消息,但不触发离线推送或通知提醒(全天免打扰)。
await OpenIM.iMManager.userManager.setSelfInfo(
  globalRecvMsgOpt: ReceiveMessageOpt.notNotify,
);

返回结果

Future 成功返回 void,表示全局消息接收方式配置请求已提交至服务端。

该操作为状态变更接口。单个会话若单独设置了个性化接收选项,其优先级通常高于全局默认策略。单会话的消息接收选项配置请参考设置会话消息接收方式。

服务端配置生效后,当前端与其他端会触发 onSelfInfoUpdated 事件通知。客户端应以 userID 为合并标识,更新本地存储的当前登录用户信息。用户资料变更事件的处理逻辑请参考更新当前用户资料。