导出导入消息

---

功能简介

凭借 ZIM SDK，您可以将当前用户客户端的本地聊天记录（单聊消息和群聊消息）导出作为备份，可用于更换设备时迁移聊天记录，或恢复被删除的消息。

前提条件

在实现“导出导入消息”功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，获取到了接入 ZIM SDK 服务所需的 AppID、AppSign。ZIM 服务权限不是默认开启的，使用前，请先在 ZEGO 控制台 自助开通 ZIM 服务（详情请参考控制台的 服务配置 - 即时通讯 - 开通服务），若无法开通 ZIM 服务，请联系 ZEGO 技术支持开通。
• 已集成 ZIM SDK，详情请参考 快速开始 - 实现基本收发消息 的 “2 集成 SDK”。

导出消息

创建 ZIM 对象并登录后，调用 exportLocalMessagesToFolderPath 接口，传入一个绝对路径，将当前用户的聊天消息保存到该目录。

导出进度，将通过 ZIMMessageExportingProgress 回调接口返回。

导出操作结果，将通过 ZIMMessageExportedCallback 回调接口返回。

// 导出消息
ZIMMessageExportConfig *config = [[ZIMMessageExportConfig alloc] init];
[self.zim exportLocalMessagesToFolderPath:@"folderPath" config: config 
                                 progress:^(unsigned long long exportedMessageCount,
                                            unsigned long long totalMessageCount) {
                                                // 导出进度回调
                                } callback:^(ZIMError *errorInfo) {
                                                // 导出结果回调
}];

导入消息

创建 ZIM 对象并登录后，调用 importLocalMessagesToFolderPath 接口，传入备份文件所在目录的绝对路径，即可导入消息。

ZIM SDK 默认读取目录中名称为 “zim_backup_msg_text” 的文件。如果该路径下存在多份备份，请确认待导入的文件名称是否为 zim_backup_msg_text。

导入进度，将通过 ZIMMessageImportingProgress 回调接口返回。

导入操作结果，将通过 ZIMMessageImportedCallback 回调接口返回。

// 导入消息
ZIMMessageImportConfig *config = [[ZIMMessageImportConfig alloc] init];
[self.zim importLocalMessagesToFolderPath:@"folderPath" config: config 
                                 progress:^(unsigned long long importedMessageCount,
                                            unsigned long long totalMessageCount) {
                                                //导入进度回调
                                } callback:^(ZIMError *errorInfo) {
                                                //导入结果回调
}];