导入和插入消息
导入和插入消息
本文介绍环信即时通讯 IM Android SDK 如何将消息导入本地数据库，以及如何在本地会话中插入消息。
这些操作仅更新当前设备上的本地消息和会话数据，不会将消息发送给会话对端，也不会向服务器上传消息或同步到当前账号的其他设备。常见使用场景包括迁移历史消息、恢复本地消息记录，以及插入撤回提示、入群通知等仅用于本地展示的消息。
技术原理
Android SDK 提供以下方式：
- 批量导入消息：调用
EMChatManager#importMessages，将当前用户发送或接收的多条消息导入本地数据库，但不会更新对应会话的最新消息等会话信息。 - 向指定会话插入消息：调用
EMConversation#insertMessage，按照消息中的 Unix 时间戳将消息插入指定会话，并更新会话的最新消息等会话信息。消息的会话 ID 必须与目标会话 ID 一致。 - 直接保存消息：调用
EMChatManager#saveMessage，将消息保存到内存和本地数据库；若对应会话不存在，SDK 会自动创建会话。
批量导入消息时，如果对应会话尚无最新消息记录，从本地数据库加载会话且过滤空会话时，该会话会被过滤，不会出现在返回的会话列表中。EMOptions#setLoadEmptyConversations 默认设置为 false，即不加载空会话。
因此，建议按会话划分待导入的消息，将每个会话中按消息时间排序的最新一条消息预留出来，其余消息通过 EMChatManager#importMessages 批量导入，待批量导入完成后，再通过对应会话的 EMConversation#insertMessage 插入预留的消息，以更新会话信息。插入前应获取或创建对应会话。“最新”以 SDK 当前消息排序配置使用的时间戳为准。例如，同一个会话有 10:00、10:01 和 10:02 三条待导入的消息，可先通过 EMChatManager#importMessages 导入前两条，再通过 EMConversation#insertMessage 插入 10:02 的消息。不要先将三条消息全部批量导入，再重复插入 10:02 的消息，否则 SDK 会因消息已存在而直接返回，不会更新会话信息。
前提条件
开始前，请确保满足以下条件：
实现方法
批量导入消息到数据库
如果你需要使用批量导入方式在本地会话中插入消息，可以调用 importMessages 方法，构造 EMMessage 对象，将消息导入本地数据库。
当前用户只能导入自己发送或接收的消息。导入后，消息保存在本地数据库中，但不会更新对应会话的最新消息等会话信息。
推荐一次导入 1,000 条以内的数据。
示例代码如下：
EMClient.getInstance().chatManager().importMessages(msgs);
插入消息
如果你需要在本地会话中加入一条消息，比如收到某些通知消息时，可以构造一条消息写入会话。
例如插入一条无需发送但有需要显示给用户看的内容，类似 “XXX 撤回一条消息”、“XXX 入群”、“对方正在输入” 等。
消息会根据消息中的 Unix 时间戳插入本地数据库，SDK 会更新会话的 latestMessage 等属性。
示例代码如下：
// 将消息插入到指定会话中。
EMConversation conversation = EMClient.getInstance().chatManager().getConversation(username);
conversation.insertMessage(message);
// 直接插入消息。若会话不存在，SDK 会自动创建会话。
EMClient.getInstance().chatManager().saveMessage(message);