IM 即时通讯
Android
开发指南

消息配置选项

更新时间: 2024/01/03 10:34:57

发送消息时可以设置消息配置选项CustomMessageConfig,主要用于设定该消息是否存离线、存入云端、写入漫游、计入未读数、支持路由等。

  • 不同类型消息的配置选项设置基本类似,本文仅以文本消息的相关设置为例进行介绍。
  • 如果发送消息时设置了不存离线消息,那么既不会有该消息的离线消息、云端历史,也不会有该消息的漫游消息。
  • 如果发送消息时配置了不存云端历史,那么既不会影响离线消息,也不会影响漫游消息。

配置示例如下:

// 该帐号为示例,请先注册
String account = "testAccount";
// 以单聊类型为例
SessionTypeEnum sessionType = SessionTypeEnum.P2P;
String text = "this is an example";
// 创建一个文本消息
IMMessage textMessage = MessageBuilder.createTextMessage(account, sessionType, text);

// 消息的配置选项
CustomMessageConfig config = new CustomMessageConfig();
// 该消息不保存到服务器
config.enableHistory = false;
// 该消息不漫游
config.enableRoaming = false;
// 该消息不同步
config.enableSelfSync = false;
textMessage.setConfig(config);

// 发送给对方
NIMClient.getService(MsgService.class).sendMessage(textMessage, false).setCallback(new RequestCallback<Void>() {
                @Override
                public void onSuccess(Void param) {

                }

                @Override
                public void onFailed(int code) {
                    
                }

                @Override
                public void onException(Throwable exception) {

                }
            });
此文档是否对你有帮助?
有帮助
去反馈