Unity
搜索云端群组
功能描述
您可以通过群 ID、群名称等信息搜索云端群组,以便快速找到所需的群组资料。这一功能特别适用于需要查找特定群组的场景,例如在社交场景中寻找兴趣群以加入。
说明:
群组云端搜索功能仅 8.6.7020 及以上版本支持。
云端搜索功能仅对专业版 Plus 和企业版客户开放,购买专业版 Plus 和企业版 后可使用;体验版支持一定额度免费试用,有效期一个月。
如果您没有开通该服务,调用接口会返回 60020 错误码。
搜索云端群组接口
您可以调用接口
GroupSearchCloudGroups 搜索云端群组。GroupSearchParam 的参数说明如下:参数 | 含义 | 说明 |
group_search_params_keyword_list | 关键字列表 | 关键字列表最多支持 5 个,keyword 会自动匹配群 ID、群名称。 |
group_search_params_keyword_list_match_type | 指定关键字列表匹配类型 | 可设置为 “或” 关系搜索,或 “与” 关系搜索。取值分别为 TIMKeywordListMatchType_Or 和 TIMKeywordListMatchType_And。默认为 “或” 关系搜索。 |
group_search_params_search_count | 搜索的数量 | 必须大于 0,最大支持 100,默认 20。 |
group_search_params_search_cursor | 搜索的游标 | 搜索的起始位置,第一次填写空字符串,续拉时填写上一次返回的 GroupSearchResult 中的 group_search_result_next_cursor。 |
群组搜索结果类
群组搜索结果类为
GroupSearchResult。参数说明如下:参数 | 含义 | 说明 |
group_search_result_is_finished | 搜索是否已完成 | 满足搜索条件的群列表是否已经全部返回。 |
group_search_result_total_count | 搜索结果总数 | 满足搜索条件的群总数量。 |
group_search_result_next_cursor | 续拉的游标 | 调用搜索接口续拉时需要填的游标。 |
group_search_result_group_list | 群列表 | 当前一次云端搜索返回的群列表。 |
示例代码如下:
GroupSearchParam groupSearchParam = new GroupSearchParam();groupSearchParam.group_search_params_keyword_list = keywordList;groupSearchParam.group_search_params_search_count = 10;TencentIMSDK.GroupSearchCloudGroups(groupSearchParam, (int code, string desc, GroupSearchResult result, string user_data) => {// 处理异步逻辑});