• IMLib / IMKit >
 
• 无 UI SDK（IMLib） >
 
• 消息相关 >
 
• 插入消息

插入消息

SDK 支持在本地数据库中插入消息。本地插入的消息不会实际发送给服务器和对方。

插入单条发送消息

在本地会话中插入一条消息，方向为发送。消息进入本地数据库，但不会发送给服务器和对方。不支持聊天室会话类型。以下示例使用 ChannelClient 下的 insertOutgoingMessage 方法。

 
ConversationType conversationType = ConversationType.PRIVATE;
String targetId = "会话 Id";
SentStatus sentStatus = SentStatus.SENT;
TextMessage content = TextMessage.obtain("这里是消息内容");
long sentTime = System.currentTimeMillis();

ChannelClient.getInstance().insertOutgoingMessage(conversationType, targetId, "", true, sentStatus, content, sentTime, new IRongCoreCallback.ResultCallback<Message>() {

        /**
         * 成功回调
         * @param message 插入的消息
         */
        @Override
        public void onSuccess(Message message) {

        }

        /**
         * 失败回调
         * @param errorCode 错误码
         */
        @Override
        public void onError(IRongCoreEnum.CoreErrorCode errorCode) {

        }
    });
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

插入本地数据库的消息如需支持消息扩展功能，必须使用 ChannelClient 下的插入方法，否则无法打开消息的可扩展属性（canIncludeExpansion）。本地插入消息时不支持设置消息扩展信息数据。App 可以选择合适的时机为消息设置扩展数据。详见消息扩展。

插入单条接收消息

本地会话中插入一条消息，方向为接收。消息不会实际发送给服务器和对方。不支持聊天室会话类型。

 
ConversationType conversationType = ConversationType.PRIVATE;
String targetId = "会话 Id";
String senderUserId = "模拟发送方的 ID";
ReceivedStatus receivedStatus = new ReceivedStatus(0x1);
TextMessage content = TextMessage.obtain("这是一条插入数据");
long sentTime = System.currentTimeMillis();

RongCoreClient.getInstance().insertIncomingMessage(conversationType, targetId, senderUserId, receivedStatus, content, sentTime, new IRongCoreCallback.ResultCallback<Message>() {
        /**
         * 成功回调
         * @param message 插入的消息
         */
        @Override
        public void onSuccess(Message message) {

        }

        /**
         * 失败回调
         * @param errorCode 错误码
         */
        @Override
        public void onError(RongIMClient.ErrorCode errorCode) {

        }
 });
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

批量插入消息

在本地数据库批量插入消息。由于批量插入失败会导致整体插入失败，建议分批插入。该接口不支持聊天室会话类型，不支持超级群会话类型。

Message 的下列属性会被入库，其余属性会被抛弃：

• UId：消息全局唯一 ID，消息成功收发后会带有由服务端生成的全局唯一 ID。SDK 从 5.3.5 开始支持入库该属性，该字段一般用于迁移数据。
• conversationType：会话类型。
• targetId：会话 ID。
• messageDirection：消息方向。
• senderUserId：发送者 ID。
• receivedStatus：接收状态；如果消息方向为接收方且未调用 message.getReceivedStatus().setRead()，该条消息为未读消息。未读消息数会累加到会话的未读消息数上。
• sentStatus：发送状态。
• content：消息的内容。
• sentTime：消息发送的 Unix 时间戳，单位为毫秒，会影响消息排序。
• extra：消息的附加信息

 
RongCoreClient.getInstance().batchInsertMessage(messages, new IRongCoreCallback.ResultCallback<Message>() {
        /**
         * 成功回调
         */
        @Override
        public void onSuccess(Boolean success) {


        }

        /**
         * 失败回调
         * @param errorCode 错误码
         */
        @Override
        public void onError(RongIMClient.ErrorCode errorCode) {

        }
 });
              

                
已复制
                复制代码
              
              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

批量插入消息提供以下重载方法，设置 enableCheck 为 true 后，SDK 会在插入时检查当前 UID 是否与数据库中 UID 重复，并移除重复项。注意，App 应自行保证插入的消息数组内部无重复的 UID。

 
    public abstract void batchInsertMessage(
            final List<Message> messages,
            boolean enableCheck,
            final IRongCoreCallback.ResultCallback<Boolean> callback);
              

                
已复制
                复制代码
              
              
1
2
3
4