浏览 SDKs · Android
平台
SDKsAndroid

设置全局消息接收方式

设置当前账号级别的全局消息接收与免打扰策略。

复制

为当前登录账号配置全局消息接收与免打扰策略,对所有单聊和群聊统一生效。

在用户资料配置对象中设置全局接收选项数值后,调用更新当前用户资料生效:

UserInfoReq request = new UserInfoReq();
request.setGlobalRecvMsgOpt(2);

OpenIMClient.getInstance().userInfoManager.setSelfInfo(
    new OnBase<String>() {
        @Override
        public void onSuccess(String data) {
            // 设置全局消息接收方式成功
        }

        @Override
        public void onError(int code, String error) {
            // 处理错误
        }
    },
    request
);

参数说明

参数类型是否必填说明
baseOnBase<String>是异步请求回调。
requestUserInfoReq是用户资料配置对象,传入包含全局接收模式数值的请求体。

消息接收模式

枚举值数值含义
ReceiveMessageOpt.Normal0正常接收消息并触发通知与推送。
ReceiveMessageOpt.NotReceive1完全屏蔽消息,不接收新消息。
ReceiveMessageOpt.NotNotify2正常接收消息但不触发通知(全局免打扰)。

返回结果

成功回调表示服务端已记录全局消息接收策略。如果产品仅提供“全局免打扰”开关,建议在 0 与 2 之间切换;数值 1 为彻底拒绝接收消息,应作为独立功能提示用户。单会话的独立接收设置请参考设置会话消息接收方式。