V2TIMMessageSearchParam
的参数说明如下:参数 | 含义 | 说明 |
keywordList | 关键字列表 | 最多支持 5 个。当消息发送者以及消息类型均未指定时,必须设置关键字列表;否则,关键字列表可以为空。 |
keywordListMatchType | 指定关键字列表匹配类型 | 可设置为 “或” 关系搜索,或 “与” 关系搜索。取值分别为 V2TIM_KEYWORD_LIST_MATCH_TYPE_OR 和 V2TIM_KEYWORD_LIST_MATCH_TYPE_AND 。默认为 “或” 关系搜索。 |
senderUserIDList | 指定 userID 发送的消息 | 最多支持 5 个。 |
messageTypeList | 指定搜索的消息类型集合 | |
conversationID | 搜索 “全部会话” 还是搜索 “指定的会话” | conversationID 为空,搜索全部会话;conversationID 不为空,搜索指定会话。 |
searchTimePosition | 搜索的起始时间点 | 默认为 0(从现在开始搜索)。UTC 时间戳,单位:秒。 |
searchTimePeriod | 从起始时间点开始的过去时间范围 | 默认为 0(不限制时间范围)。24x60x60 代表过去一天。单位:秒。 |
pageIndex | 分页的页号 | 用于分页展示查找结果,0 表示首页。 |
pageSize | 每页结果数量 | 用于分页展示查找结果,如不希望分页可将其设置成 0。但如果结果数量太多,一次性拉取可能会引发性能问题。 |
参数 | 含义 | 说明 |
totalCount | 搜索结果总数 | 如果搜索指定会话,返回满足搜索条件的消息总数; 如果搜索全部会话,返回满足搜索条件的消息所在的所有会话总数量。 |
messageSearchResultItems | 指定关键字列表匹配类型 | 如果搜索指定会话,返回结果列表只包含该会话结果; 如果搜索全部会话,会对满足搜索条件的消息根据会话 ID 分组,分页返回分组结果。 |
messageSearchResultItems
是个列表,内含 V2TIMMessageSearchResultItem
(Android / iOS & Mac / Windows) 对象,参数说明如下:参数 | 含义 | 说明 |
conversationID | 会话 ID | —— |
messageCount | 消息数量 | 当前会话一共搜索到了多少条符合要求的消息。 |
messageList | 满足搜索条件的消息列表 | 如果搜索指定会话, messageList 中装载的是本会话中所有满足搜索条件的消息列表。如果搜索全部会话, messageList 中装载的消息条数会有如下两种可能:如果某个会话中匹配到的消息条数 > 1,则 messageList 为空,您可以在 UI 上显示 “{messageCount } 条相关记录”。如果某个会话中匹配到的消息条数 = 1,则 messageList 为匹配到的那条消息,您可以在 UI 上显示之,并高亮匹配关键词。 |
V2TIMMessageSearchParam
中的 conversationID
设置为空或者不设置即可。List<String> keywordList = new ArrayList<>();keywordList.add("abc");keywordList.add("123");V2TIMMessageSearchParam searchParam = new V2TIMMessageSearchParam();// 设置搜索关键字searchParam.setKeywordList(keywordList);// 搜索第 0 页数据searchParam.setPageIndex(0);// 每页搜索 10 条数据searchParam.setPageSize(10);V2TIMManager.getMessageManager().searchLocalMessages(searchParam, new V2TIMValueCallback<V2TIMMessageSearchResult>() {@Overridepublic void onSuccess(V2TIMMessageSearchResult v2TIMMessageSearchResult) {// 搜索成功}@Overridepublic void onError(int code, String desc) {// 搜索失败}});
V2TIMMessageSearchParam *param = [[V2TIMMessageSearchParam alloc] init];// 设置搜索关键字param.keywordList = @[@"abc", @"123"];param.messageTypeList = nil;param.conversationID = nil;param.searchTimePosition = 0;param.searchTimePeriod = 0;// 搜索第 0 页数据param.pageIndex = 0;// 每页搜索 10 条数据param.pageSize = 10;[V2TIMManager.sharedInstance searchLocalMessages:paramsucc:^(V2TIMMessageSearchResult *searchResult) {// 搜索成功,searchResult 中返回搜索结果} fail:^(int code, NSString *desc) {// 搜索失败}];
template <class T>class ValueCallback final : public V2TIMValueCallback<T> {public:using SuccessCallback = std::function<void(const T&)>;using ErrorCallback = std::function<void(int, const V2TIMString&)>;ValueCallback() = default;~ValueCallback() override = default;void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {success_callback_ = std::move(success_callback);error_callback_ = std::move(error_callback);}void OnSuccess(const T& value) override {if (success_callback_) {success_callback_(value);}}void OnError(int error_code, const V2TIMString& error_message) override {if (error_callback_) {error_callback_(error_code, error_message);}}private:SuccessCallback success_callback_;ErrorCallback error_callback_;};V2TIMMessageSearchParam searchParam;// 设置搜索关键字searchParam.keywordList.PushBack("abc");searchParam.keywordList.PushBack("123");// 搜索第 0 页数据searchParam.pageIndex = 0;// 每页搜索 10 条数据searchParam.pageSize = 10;auto callback = new ValueCallback<V2TIMMessageSearchResult>{};callback->SetCallback([=](const V2TIMMessageSearchResult& messageSearchResult) {// 搜索成功delete callback;},[=](int error_code, const V2TIMString& error_message) {// 搜索失败delete callback;});V2TIMManager::GetInstance()->GetMessageManager()->SearchLocalMessages(searchParam, callback);
List<String> keywordList = new ArrayList<>();keywordList.add("abc");keywordList.add("123");V2TIMMessageSearchParam searchParam = new V2TIMMessageSearchParam();// 搜索与用户 user1 的单聊消息searchParam.setConversationID("c2c_user1");// 设置搜索关键字searchParam.setKeywordList(keywordList);// 搜索第 0 页数据searchParam.setPageIndex(0);// 每页搜索 10 条数据searchParam.setPageSize(10);V2TIMManager.getMessageManager().searchLocalMessages(searchParam, new V2TIMValueCallback<V2TIMMessageSearchResult>() {@Overridepublic void onSuccess(V2TIMMessageSearchResult v2TIMMessageSearchResult) {// 搜索成功}@Overridepublic void onError(int code, String desc) {// 搜索失败}});
V2TIMMessageSearchParam *param = [[V2TIMMessageSearchParam alloc] init];// 设置搜索关键字param.keywordList = @[@"abc", @"123"];param.messageTypeList = nil;// 搜索与用户 user1 的单聊消息param.conversationID = @"c2c_user1";param.searchTimePosition = 0;param.searchTimePeriod = 0;// 搜索第 0 页数据param.pageIndex = 0;// 每页搜索 10 条数据param.pageSize = 10;[V2TIMManager.sharedInstance searchLocalMessages:paramsucc:^(V2TIMMessageSearchResult *searchResult) {// 搜索成功,searchResult 中返回搜索结果} fail:^(int code, NSString *desc) {// 搜索失败}];
template <class T>class ValueCallback final : public V2TIMValueCallback<T> {public:using SuccessCallback = std::function<void(const T&)>;using ErrorCallback = std::function<void(int, const V2TIMString&)>;ValueCallback() = default;~ValueCallback() override = default;void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {success_callback_ = std::move(success_callback);error_callback_ = std::move(error_callback);}void OnSuccess(const T& value) override {if (success_callback_) {success_callback_(value);}}void OnError(int error_code, const V2TIMString& error_message) override {if (error_callback_) {error_callback_(error_code, error_message);}}private:SuccessCallback success_callback_;ErrorCallback error_callback_;};V2TIMMessageSearchParam searchParam;// 搜索与用户 user1 的单聊消息searchParam.conversationID = "c2c_user1";// 设置搜索关键字searchParam.keywordList.PushBack("abc");searchParam.keywordList.PushBack("123");// 搜索第 0 页数据searchParam.pageIndex = 0;// 每页搜索 10 条数据searchParam.pageSize = 10;auto callback = new ValueCallback<V2TIMMessageSearchResult>{};callback->SetCallback([=](const V2TIMMessageSearchResult& messageSearchResult) {// 搜索成功delete callback;},[=](int error_code, const V2TIMString& error_message) {// 搜索失败delete callback;});V2TIMManager::GetInstance()->GetMessageManager()->SearchLocalMessages(searchParam, callback);
图 1:搜索聊天记录 | 图 2:搜索更多聊天记录 | 图 3:搜索指定会话的消息 |
| | |
V2TIMMessageSearchParam
conversationID
设置为 null
,表示搜索所有会话的消息。pageIndex
设置为 0,表示搜索到的消息所属的会话的首页数据。pageSize
设置为 3,表示返回最近的会话数量,UI 上一般显示 3 条。V2TIMMessageSearchResult
totalCount
表示匹配到的消息所属的所有会话数量。messageSearchResultItems
列表为最近 3(即入参 pageSize
)个会话信息。其中元素 V2TIMMessageSearchResultItem
的 messageCount
表示当前会话搜索到的消息总数量;messageList
为空,您可以在 UI 上显示 “4 条相关聊天记录”,其中的 4 为 messageCount
。messageList
为匹配到的那条消息,您可以在 UI 上显示消息内容并高亮搜索关键词,例如图中的 “test”。List<String> keywordList = new ArrayList<>();keywordList.add("test");V2TIMMessageSearchParam v2TIMMessageSearchParam = new V2TIMMessageSearchParam();// conversationID 设置为 null 表示搜索所有会话中的消息,结果会按照会话分类v2TIMMessageSearchParam.setConversationID(null);v2TIMMessageSearchParam.setKeywordList(keywordList);v2TIMMessageSearchParam.setPageSize(3);v2TIMMessageSearchParam.setPageIndex(0);V2TIMManager.getMessageManager().searchLocalMessages(v2TIMMessageSearchParam, new V2TIMValueCallback<V2TIMMessageSearchResult>() {@Overridepublic void onSuccess(V2TIMMessageSearchResult v2TIMMessageSearchResult) {// 匹配到的消息所属的所有会话数量int totalCount = v2TIMMessageSearchResult.getTotalCount();// 最近3个根据消息会话分类的信息List<V2TIMMessageSearchResultItem> resultItemList = v2TIMMessageSearchResult.getMessageSearchResultItems();for (V2TIMMessageSearchResultItem resultItem : resultItemList) {// 会话 IDString conversationID = resultItem.getConversationID();// 该会话匹配到的所有消息数量int totalMessageCount = resultItem.getMessageCount();// 消息列表:如果 totalMessageCount > 1,该列表为空;如果 totalMessageCount = 1,该列表元素为此消息List<V2TIMMessage> v2TIMMessageList = resultItem.getMessageList();}}@Overridepublic void onError(int code, String desc) {}});
V2TIMMessageSearchParam *param = [[V2TIMMessageSearchParam alloc] init];param.keywordList = @[@"test"];// conversationID 设置为 nil 表示搜索所有会话中的消息,结果会按照会话分类param.conversationID = nil;param.pageIndex = 0;param.pageSize = 3;[V2TIMManager.sharedInstance searchLocalMessages:param succ:^(V2TIMMessageSearchResult *searchResult) {// 匹配到的消息所属的所有会话数量NSInteger totalCount = searchResult.totalCount;// 最近3个根据消息会话分类的信息NSArray<V2TIMMessageSearchResultItem *> *messageSearchResultItems = searchResult.messageSearchResultItems;for (V2TIMMessageSearchResultItem *searchItem in messageSearchResultItems) {// 会话 IDNSString *conversationID = searchItem.conversationID;// 该会话匹配到的所有消息数量NSUInteger messageCount = searchItem.messageCount;// 消息列表NSArray<V2TIMMessage *> *messageList = searchItem.messageList ?: @[];}} fail:^(int code, NSString *desc) {// fail}];
template <class T>class ValueCallback final : public V2TIMValueCallback<T> {public:using SuccessCallback = std::function<void(const T&)>;using ErrorCallback = std::function<void(int, const V2TIMString&)>;ValueCallback() = default;~ValueCallback() override = default;void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {success_callback_ = std::move(success_callback);error_callback_ = std::move(error_callback);}void OnSuccess(const T& value) override {if (success_callback_) {success_callback_(value);}}void OnError(int error_code, const V2TIMString& error_message) override {if (error_callback_) {error_callback_(error_code, error_message);}}private:SuccessCallback success_callback_;ErrorCallback error_callback_;};V2TIMMessageSearchParam searchParam;// conversationID 设置为空表示搜索所有会话中的消息,结果会按照会话分类searchParam.conversationID = {};searchParam.keywordList.PushBack("test");searchParam.pageIndex = 0;searchParam.pageSize = 3;auto callback = new ValueCallback<V2TIMMessageSearchResult>{};callback->SetCallback([=](const V2TIMMessageSearchResult& messageSearchResult) {// 匹配到的消息所属的所有会话数量uint32_t totalCount = messageSearchResult.totalCount;// 最近3个根据消息会话分类的信息V2TIMMessageSearchResultItemVector messageSearchResultItems =messageSearchResult.messageSearchResultItems;for (size_t i = 0; i < messageSearchResultItems.Size(); ++i) {// 会话 IDV2TIMString conversationID = messageSearchResultItems[i].conversationID;// 该会话匹配到的所有消息数量uint32_t messageCount = messageSearchResultItems[i].messageCount;// 消息列表:如果 messageCount > 1,该列表为空;如果 messageCount = 1,该列表元素为此消息V2TIMMessageVector messageList = messageSearchResultItems[i].messageList;}delete callback;},[=](int error_code, const V2TIMString& error_message) {// 搜索失败delete callback;});V2TIMManager::GetInstance()->GetMessageManager()->SearchLocalMessages(searchParam, callback);
V2TIMMessageSearchParam
可以参考如下设置:pageSize
= 10,pageIndex
= 0。调用 searchLocalMessages
获取消息搜索结果,解析并展示到首页,并且从结果回调中的 totalCount 获取会话总数量。totalCount
% pageSize
== 0) ? (totalCount
/ pageSize
) : (totalCount
/ pageSize
+ 1) 。pageIndex
(pageIndex
< totalPage)查询后续指定页数的搜索结果。......// 每页展示数量为10条,计算总页数int totalPage = (totalCount % 10 == 0) ? (totalCount / 10) : (totalCount / 10 + 1);......private void searchConversation(int index) {if (index >= totalPage) {return;}List<String> keywordList = new ArrayList<>();keywordList.add("test");V2TIMMessageSearchParam v2TIMMessageSearchParam = new V2TIMMessageSearchParam();v2TIMMessageSearchParam.setConversationID(null);v2TIMMessageSearchParam.setKeywordList(keywordList);v2TIMMessageSearchParam.setPageSize(10);v2TIMMessageSearchParam.setPageIndex(index);V2TIMManager.getMessageManager().searchLocalMessages(v2TIMMessageSearchParam, new V2TIMValueCallback<V2TIMMessageSearchResult>() {@Overridepublic void onSuccess(V2TIMMessageSearchResult v2TIMMessageSearchResult) {// 匹配到的消息所属的所有会话数量int totalCount = v2TIMMessageSearchResult.getTotalCount();// 每页展示数量为10条,计算总页数int totalPage = (totalCount % 10 == 0) ? (totalCount / 10) : (totalCount / 10 + 1);// 该页的根据消息会话分类的信息List<V2TIMMessageSearchResultItem> resultItemList = v2TIMMessageSearchResult.getMessageSearchResultItems();for (V2TIMMessageSearchResultItem resultItem : resultItemList) {// 会话 IDString conversationID = resultItem.getConversationID();// 该会话匹配到的所有消息数量int totalMessageCount = resultItem.getMessageCount();// 消息列表:如果 totalMessageCount > 1,该列表为空;如果 totalMessageCount = 1,该列表元素为此消息List<V2TIMMessage> v2TIMMessageList = resultItem.getMessageList();}@Overridepublic void onError(int code, String desc) {}});}// 当需要加载下一页时public void loadMore() {searchConversation(++pageIndex);}
......// 每页展示数量为10条,计算总页数NSInteger totalPage = (totalCount % 10 == 0) ? (totalCount / 10) : (totalCount / 10 + 1);......- (void)searchConversation:(NSUInteger)index {if (index >= totalPage) {return;}V2TIMMessageSearchParam *param = [[V2TIMMessageSearchParam alloc] init];param.keywordList = @[@"test"];param.conversationID = nil;param.pageIndex = index;param.pageSize = 10;[V2TIMManager.sharedInstance searchLocalMessages:param succ:^(V2TIMMessageSearchResult *searchResult) {// 匹配到的消息所属的所有会话数量NSUInteger totalCount = searchResult.totalCount;// 每页展示数量为10条,计算总页数NSUInteger totalPage = (totalCount % 10 == 0) ? (totalCount / 10) : (totalCount / 10 + 1);// 该页的根据消息会话分类的信息NSArray<V2TIMMessageSearchResultItem *> *messageSearchResultItems = searchResult.messageSearchResultItems;for (V2TIMMessageSearchResultItem *searchItem in messageSearchResultItems) {// 会话 IDNSString *conversationID = searchItem.conversationID;// 该会话匹配到的所有消息数量NSUInteger totalMessageCount = searchItem.messageCount;// 消息列表:如果 totalMessageCount > 1,该列表为空;如果 totalMessageCount = 1,该列表元素为此消息NSArray<V2TIMMessage *> *messageList = searchItem.messageList ?: @[];}} fail:^(int code, NSString *desc) {// fail}];}// 当需要加载下一页时- (void)loadMore {[self searchConversation:++pageIndex];}
template <class T>class ValueCallback final : public V2TIMValueCallback<T> {public:using SuccessCallback = std::function<void(const T&)>;using ErrorCallback = std::function<void(int, const V2TIMString&)>;ValueCallback() = default;~ValueCallback() override = default;void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {success_callback_ = std::move(success_callback);error_callback_ = std::move(error_callback);}void OnSuccess(const T& value) override {if (success_callback_) {success_callback_(value);}}void OnError(int error_code, const V2TIMString& error_message) override {if (error_callback_) {error_callback_(error_code, error_message);}}private:SuccessCallback success_callback_;ErrorCallback error_callback_;};// 每页展示数量为10条,计算总页数uint32_t totalPage = (totalCount % 10 == 0) ? (totalCount / 10) : (totalCount / 10 + 1);void SearchConversation(uint32_t index) {if (index >= totalPage) {return;}V2TIMMessageSearchParam searchParam;searchParam.keywordList.PushBack("test");searchParam.pageIndex = index;searchParam.pageSize = 10;auto callback = new ValueCallback<V2TIMMessageSearchResult>{};callback->SetCallback([=](const V2TIMMessageSearchResult& messageSearchResult) {// 匹配到的消息所属的所有会话数量uint32_t totalCount = messageSearchResult.totalCount;// 每页展示数量为10条,计算总页数uint32_t totalPage = (totalCount % 10 == 0) ? (totalCount / 10) : (totalCount / 10 + 1);// 该页的根据消息会话分类的信息V2TIMMessageSearchResultItemVector messageSearchResultItems =messageSearchResult.messageSearchResultItems;for (size_t i = 0; i < messageSearchResultItems.Size(); ++i) {// 会话 IDV2TIMString conversationID = messageSearchResultItems[i].conversationID;// 该会话匹配到的所有消息数量uint32_t messageCount = messageSearchResultItems[i].messageCount;// 消息列表:如果 messageCount > 1,该列表为空;如果 messageCount = 1,该列表元素为此消息V2TIMMessageVector messageList = messageSearchResultItems[i].messageList;}delete callback;},[=](int error_code, const V2TIMString& error_message) {// 搜索失败delete callback;});V2TIMManager::GetInstance()->GetMessageManager()->SearchLocalMessages(searchParam, callback);}// 当需要加载下一页时void LoadMore() { SearchConversation(++pageIndex); }
V2TIMMessageSearchParam
可以参考如下设置(pageIndex
的计算与上一节一致):V2TIMMessageSearchParam
的 conversationID
为搜索的会话 ID。pageSize
= 10,pageIndex
= 0。调用 searchLocalMessages
获取消息搜索结果,解析并展示到首页,并且从结果回调中的 totalCount 获取会话总数量。totalCount
% pageSize
== 0) ? (totalCount
/ pageSize
) : (totalCount
/ pageSize
+ 1) 。pageIndex
(pageIndex
< totalPage)查询后续指定页数的搜索结果。V2TIMMessageSearchResult
:totalCount
表示该会话匹配到的所有消息数量。messageSearchResultItems
列表只有该会话的结果。列表中的元素 V2TIMMessageSearchResultItem
的 messageCount
为该分页的消息数量,messageList
为该分页的消息列表。......// 每页展示数量为10条,计算总页数int totalMessagePage = (totalMessageCount % 10 == 0) ? (totalMessageCount / 10) : (totalMessageCount / 10 + 1);......private void searchMessage(int index) {if (index >= totalMessagePage) {return;}List<String> keywordList = new ArrayList<>();keywordList.add("test");V2TIMMessageSearchParam v2TIMMessageSearchParam = new V2TIMMessageSearchParam();v2TIMMessageSearchParam.setConversationID(conversationID);v2TIMMessageSearchParam.setKeywordList(keywordList);v2TIMMessageSearchParam.setPageSize(10);v2TIMMessageSearchParam.setPageIndex(index);V2TIMManager.getMessageManager().searchLocalMessages(v2TIMMessageSearchParam, new V2TIMValueCallback<V2TIMMessageSearchResult>() {@Overridepublic void onSuccess(V2TIMMessageSearchResult v2TIMMessageSearchResult) {// 该会话匹配到的所有消息数量int totalMessageCount = v2TIMMessageSearchResult.getTotalCount();// 每页展示数量为10条,计算总页数int totalMessagePage = (totalMessageCount % 10 == 0) ? (totalMessageCount / 10) : (totalMessageCount / 10 + 1);// 该页消息信息List<V2TIMMessageSearchResultItem> resultItemList = v2TIMMessageSearchResult.getMessageSearchResultItems();for (V2TIMMessageSearchResultItem resultItem : resultItemList) {// 会话 IDString conversationID = resultItem.getConversationID();// 该页的消息数量int totalMessageCount = resultItem.getMessageCount();// 该页的消息数据列表List<V2TIMMessage> v2TIMMessageList = resultItem.getMessageList();}}@Overridepublic void onError(int code, String desc) {}});}// 当需要加载下一页时public void loadMore() {searchMessage(++pageIndex);}
......// 每页展示数量为10条,计算总页数NSInteger totalMessagePage = (totalMessageCount % 10 == 0) ? (totalMessageCount / 10) : (totalMessageCount / 10 + 1);......- (void)searchMessage:(NSUInteger)index {if (index >= totalMessagePage) {return;}V2TIMMessageSearchParam *param = [[V2TIMMessageSearchParam alloc] init];param.keywordList = @[@"test"];param.conversationID = conversationID;param.pageIndex = index;param.pageSize = 10;[V2TIMManager.sharedInstance searchLocalMessages:param succ:^(V2TIMMessageSearchResult *searchResult) {// 该会话匹配到的所有消息数量NSUInteger totalMessageCount = searchResult.totalCount;// 每页展示数量为10条,计算总页数NSUInteger totalMessagePage = (totalMessageCount % 10 == 0) ? (totalMessageCount / 10) : (totalMessageCount / 10 + 1);// 该页消息信息NSArray<V2TIMMessageSearchResultItem *> *messageSearchResultItems = searchResult.messageSearchResultItems;for (V2TIMMessageSearchResultItem *searchItem in messageSearchResultItems) {// 会话 IDNSString *conversationID = searchItem.conversationID;// 该页的消息数量NSUInteger totalMessageCount = searchItem.messageCount;// 该页的消息数据列表NSArray<V2TIMMessage *> *messageList = searchItem.messageList ?: @[];}} fail:^(int code, NSString *desc) {// fail}];}// 当需要加载下一页时- (void)loadMore {[self searchMessage:++pageIndex];}
template <class T>class ValueCallback final : public V2TIMValueCallback<T> {public:using SuccessCallback = std::function<void(const T&)>;using ErrorCallback = std::function<void(int, const V2TIMString&)>;ValueCallback() = default;~ValueCallback() override = default;void SetCallback(SuccessCallback success_callback, ErrorCallback error_callback) {success_callback_ = std::move(success_callback);error_callback_ = std::move(error_callback);}void OnSuccess(const T& value) override {if (success_callback_) {success_callback_(value);}}void OnError(int error_code, const V2TIMString& error_message) override {if (error_callback_) {error_callback_(error_code, error_message);}}private:SuccessCallback success_callback_;ErrorCallback error_callback_;};// 每页展示数量为10条,计算总页数uint32_t totalPage = (totalCount % 10 == 0) ? (totalCount / 10) : (totalCount / 10 + 1);void SearchConversation(uint32_t index) {if (index >= totalPage) {return;}V2TIMMessageSearchParam searchParam;searchParam.conversationID = conversationID;searchParam.keywordList.PushBack("test");searchParam.pageIndex = index;searchParam.pageSize = 10;auto callback = new ValueCallback<V2TIMMessageSearchResult>{};callback->SetCallback([=](const V2TIMMessageSearchResult& messageSearchResult) {// 该会话匹配到的所有消息数量uint32_t totalCount = messageSearchResult.totalCount;// 每页展示数量为10条,计算总页数uint32_t totalPage = (totalCount % 10 == 0) ? (totalCount / 10) : (totalCount / 10 + 1);// 该页消息信息V2TIMMessageSearchResultItemVector messageSearchResultItems =messageSearchResult.messageSearchResultItems;for (size_t i = 0; i < messageSearchResultItems.Size(); ++i) {// 会话 IDV2TIMString conversationID = messageSearchResultItems[i].conversationID;// 该页的消息数量uint32_t messageCount = messageSearchResultItems[i].messageCount;// 该页的消息数据列表V2TIMMessageVector messageList = messageSearchResultItems[i].messageList;}delete callback;},[=](int error_code, const V2TIMString& error_message) {// 搜索失败delete callback;});V2TIMManager::GetInstance()->GetMessageManager()->SearchLocalMessages(searchParam, callback);}// 当需要加载下一页时void LoadMore() { SearchConversation(++pageIndex); }
createCustomMessage(data)
(Android / iOS & Mac / Windows) 创建自定义消息,该消息无法被搜到,因为 SDK 将该自定义消息保存为二进制数据流。createCustomMessage(data, description, extension)
(Android / iOS & Mac / Windows) 来创建并发送自定义消息,把需要搜索的文本放到 description
参数中。description
后,自定义消息也会有离线推送且通知栏展示该参数内容。
如果不需要离线推送可以用发消息接口 sendMessage
(Android / iOS & Mac / Windows) 的参数 V2TIMOfflinePushInfo
中的 disablePush
来控制。V2TIMOfflinePushInfo
中的 desc
来另外设置推送内容。createFileMessage
创建文件消息时传入 fileName
参数,fileName
会作为文件消息被搜索的内容,与搜索关键词进行匹配。如果未设置 fileName
,SDK 则会自动从 filePath
提取文件名作为搜索内容。
fileName
和 filePath
信息会保存到本地和服务器,换设备拉取相关信息后均可搜索。fileName
这种名称,界面通常显示缩略图或时长,此时指定 keywordList
搜索无效。
如果您希望搜索出此类消息,可以指定 messageTypeList
为 V2TIM_ELEM_TYPE_IMAGE
/V2TIM_ELEM_TYPE_SOUND
/V2TIM_ELEM_TYPE_VIDEO
做分类搜索,此时会搜索出所有指定类型的消息。
本页内容是否解决了您的问题?