搜索消息
搜索消息
本文介绍环信即时通讯 IM iOS SDK 如何搜索本地消息。调用本文中的消息搜索方法可以搜索本地数据库中除命令消息之外的所有类型的消息，因为命令消息不在本地数据库中存储。
技术原理
环信即时通讯 IM iOS SDK 支持搜索用户设备上存储的消息数据，其中包含如下主要方法：
IEMChatManager.loadMessagesWithKeyword根据关键字搜索本地数据库中单个会话中指定用户发送的消息。EMChatManager#loadMessagesWithKeyword:timestamp:count:fromUser:searchDirection:scope:completion:: 根据关键字搜索消息时，可以选择搜索范围在所有会话中进行消息搜索。EMConversation#loadMessagesWithKeyword:timestamp:count:fromUser:searchDirection:scope:completion:：根据关键字搜索消息时，可以选择搜索范围在当前会话中进行消息搜索。 -EMChatManager#searchMessages:withTypes:timestamp:count:fromuser:searchDirection:completion:：根据单个或多个消息类型，搜索本地数据库中所有会话的消息。EMConversation#searchMessages:withTypes:timestamp:count:fromuser:searchDirection:completion:根据单个或多个消息类型，搜索本地数据库中单个会话的消息。
前提条件
开始前，请确保满足以下条件：
实现方法
根据关键字搜索会话中的用户发送的消息
你可以调用 loadMessagesWithKeyword 方法根据关键字搜索本地数据库中单个会话中指定用户发送的消息，示例代码如下：
// 同步方法，异步方法见[EMConversation loadMessagesWithKeyword:timestamp:count:fromUser:searchDirection:completion]
EMConversation* conversation = [EMClient.sharedClient.chatManager getConversationWithConvId:@"conversationId"];
NSArray<EMChatMessage *> *messages = [conversation loadMessagesWithKeyword:@"keyword" timestamp:0 count:50 fromUser:nil searchDirection:EMMessageSearchDirectionDown];
根据搜索范围搜索所有会话中的消息
你可以调用 EMChatManager#loadMessagesWithKeyword:timestamp:count:fromUser:searchDirection:scope:completion: 方法，除了设置关键字、消息时间戳、消息数量、发送方、搜索方向等条件搜索所有会话中的消息时，你还可以选择搜索范围，如只搜索消息内容、只搜索消息扩展信息以及同时搜索消息内容以及扩展信息。
提示
若使用该功能，需将 SDK 升级至 V4.4.0 或以上版本。
EMClient.shared().chatManager?.loadMessages(withKeyword: "keyword", timestamp: 0, count: 50, fromUser: "", searchDirection: .down, scope: .content, completion: { messages, aError in
})
根据搜索范围搜索当前会话中的消息
你可以调用 EMConversation#loadMessagesWithKeyword:timestamp:count:fromUser:searchDirection:scope:completion: 方法除了设置关键字、消息时间戳、消息数量、发送方、搜索方向等条件搜索当前会话中的消息，你还可以选择搜索范围，如只搜索消息内容、只搜索消息扩展信息以及同时搜索消息内容以及扩展信息。
提示
若使用该功能，需将 SDK 升级至 V4.4.0 或以上版本。
if let conversation = EMClient.shared().chatManager?.getConversationWithConvId("conversationsId") {
conversation.loadMessages(withKeyword: "keyword", timestamp: 0, count: 50, fromUser: "", searchDirection: .down, scope: .content, completion: { messages, aError in
})
}
根据消息类型搜索所有会话中的消息
你可以调用 EMChatManager#searchMessages:withTypes:timestamp:count:fromuser:searchDirection:completion: 方法除了设置消息时间戳、消息数量、发送方、搜索方向等条件搜索当前会话中的消息，你还可以设置单个或多个消息类型搜索本地数据库中所有会话的消息。
提示
若使用该功能，需将 SDK 升级至 V4.7.0 或以上版本。
// count：要查询的消息条数。取值范围为 [1,400]。
// fromuser：会话中发送方的用户 ID。若传空字符串，搜索对发送方不限制。
EMClient.shared().chatManager?.searchMessages (withTypes: [NSNumber (integerLiteral:
EMMessageBodyType.text.rawValue), NSNumber (integerLiteral: EMMessageBodyType.image.rawValue)], timestamp：-1, count:10, fromuser："user123",searchDirection:.up,completion: { messages, error in
})
根据消息类型搜索当前会话中的消息
你可以调用 EMConversation#searchMessages:withTypes:timestamp:count:fromuser:searchDirection:completion: 方法除了设置消息时间戳、消息数量、发送方、搜索方向等条件搜索当前会话中的消息，你还可以设置单个或多个消息类型搜索本地数据库中单个会话的消息。
提示
若使用该功能，需将 SDK 升级至 V4.7.0 或以上版本。
// count：要查询的消息条数。取值范围为 [1,400]。
// fromuser：当前会话中发送方的用户 ID。若传空字符串，搜索对发送方不限制。
EMConversation().searchMessages(withTypes: [NSNumber(integerLiteral: EMMessageBodyType.text.rawValue),NSNumber(integerLiteral: EMMessageBodyType.image.rawValue)], timestamp: -1, count: 20, fromUser: "send message user id", searchDirection: .up) { messages, error in
}
关键字搜索规则
调用以下消息搜索 API 搜索不同类型的消息时，其中的 keywords 参数对应不同的内容。
只搜索消息内容
| 消息类型 | 关键字匹配的消息内容 | 关键字搜索内容示例 |
|---|---|---|
| 文本消息 | EMTextMessageBody#text | 文本消息的实际内容“你好世界”。 |
| 图片消息 | EMImageMessageBody#displayName | 图片文件名“photo.jpg”。 |
| 语音消息 | EMVoiceMessageBody#displayName | 语音文件名“audio.amr”。 |
| 视频消息 | EMVideoMessageBody#displayName | 视频文件名“video.mp4”。 |
| 文件消息 | EMFileMessageBody#displayName | 文件名“report.pdf”。 |
| 位置消息 | EMLocationMessageBody#address 和 EMLocationMessageBody#buildingName | 地址\建筑物名称“北京市朝阳区\国贸大厦” |
| 自定义消息 | EMCustomMessageBody#event | 自定义事件名“gift” |
| 合并消息 | EMCombineMessageBody#title 和 EMCombineMessageBody#summary | 标题\摘要“聊天记录\包含5条消息” |
只搜索扩展信息
若只搜索消息的扩展属性（ext）JSON 字符串，keywords 字段匹配用户自定义添加的扩展属性，例如：
{"key1":"value1", "key2":"value2"}
全搜索
同时搜索消息内容和扩展信息，任一匹配即返回。