即时通信 IM Unity(搜索群成员)

可以以通过群成员 ID、昵称、名片等信息搜索云端群成员。这一功能特别适用于需要快速查找特定群成员的场景,例如在大型群组中快速查找某个群成员信息。

相关产品
即时通信 IM 产品页,含版本规格、价格与购买入口。

一、功能描述

注意:说明:

二、搜索云端群成员接口

你可以调用接口 GroupSearchCloudGroupMembers 搜索云端群成员。

GroupMemberSearchParam 的参数说明如下:

参数 含义 说明
group_search_member_params_keyword_list 关键字列表 关键字列表最多支持 5 个,keyword 会自动匹配群成员 ID、昵称、群名片。
group_member_search_params_keyword_list_match_type 指定关键字列表匹配类型 可设置为 “或” 关系搜索,或 “与” 关系搜索。取值分别为 TIMKeywordListMatchType_Or 和 TIMKeywordListMatchType_And。默认为 “或” 关系搜索。
group_search_member_params_groupid_list 指定群 ID 列表 如果设置为空,代表搜索全部群中的群成员,返回的结果会按照 groupID 进行分类;如果设置不为空,则代表搜索指定群中的群成员。
group_member_search_params_search_count 搜索的数量 必须大于 0,最大支持 100,默认 20。
group_member_search_params_search_cursor 搜索的游标 搜索的起始位置,第一次填写空字符串,续拉时填写上一次返回的 GroupMemberSearchResult 中的 group_member_search_result_next_cursor。

三、群成员搜索结果类

群成员搜索结果类为GroupMemberSearchResult。参数说明如下:

参数 含义 说明
group_member_search_result_is_finished 搜索是否已完成 满足搜索条件的群成员列表是否已经全部返回。
group_member_search_result_total_count 搜索结果总数 满足搜索条件的群成员总数量。
group_member_search_result_next_cursor 续拉的游标 调用搜索接口续拉时需要填的游标。
group_member_search_result_member_list 群成员列表 当前一次云端搜索返回的群成员列表。

示例代码如下:

GroupMemberSearchParam groupMemberSearchParam = new GroupMemberSearchParam();groupMemberSearchParam.group_search_member_params_keyword_list = keywordList;groupMemberSearchParam.group_search_member_params_groupid_list = groupIDs;groupMemberSearchParam.group_member_search_params_search_count = 10;TIMResult res = TencentIMSDK.GroupSearchCloudGroupMembers(groupMemberSearchParam, (int code, string desc, GroupMemberSearchResult result, string user_data) => { // 处理异步逻辑});

赞 (0)
上一篇 4天前
下一篇 4天前