logo
当前页

导出导入消息


功能简介

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

注意

强烈建议开发者在迁移消息过程中对备份文件进行加密,以免泄露用户数据。

导出消息

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

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

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

说明

本接口导出的消息文件名称为 zim_backup_msg_text。如果多次调用本接口时,传入的路径相同,ZIM SDK 会自行将旧的 zim_backup_msg_text 文件更名,以确保最新导出的文件名称为 zim_backup_msg_text。

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

导入消息

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

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

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

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

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

Previous

消息表态

Next

接收 Tips 消息