Unity

搜索云端用户
功能描述
您可以通过用户 ID、昵称、性别等信息来搜索云端用户，以便快速找到所需的用户资料。此功能适用于需要查找特定用户信息的场合，例如在熟人社交场景中查找用户以加好友，或者在陌生人社交场景中查找用户以关注。
说明：
用户云端搜索功能仅 8.6.7020 及以上版本支持。
云端搜索功能仅对专业版 Plus 和企业版客户开放，购买专业版 Plus 和企业版 后可使用；体验版支持一定额度免费试用，有效期一个月。
如果您没有开通该服务，调用接口会返回 60020 错误码。
搜索云端用户接口
调用接口 searchUsers 可以搜索云端用户资料，该接口返回的是云端存储的用户资料，包括好友和非好友资料，您可以调用 FriendshipCheckFriendType 接口来判断是否为好友。
UserSearchParam 的参数说明如下：
参数
含义
说明
user_search_param_keyword_list
关键字列表
关键字列表最多支持 5 个，keyword 会自动匹配用户 ID、昵称。
user_search_param_keyword_list_match_type
指定关键字列表匹配类型
可设置为 “或” 关系搜索，或 “与” 关系搜索。取值分别为 TIMKeywordListMatchType_Or 和 TIMKeywordListMatchType_And。默认为 “或” 关系搜索。
user_search_param_gender
用户性别
如果不设置，默认男性和女性都会返回。
user_search_param_min_birthday
用户最小生日
如果不设置，默认值为 0。
user_search_param_max_birthday
用户最大生日
如果不设置，默认 birthday >= minBirthday 的用户都会返回。
user_search_param_search_count
搜索的数量
必须大于 0，最大支持 100，默认 20。
user_search_param_search_cursor
搜索的游标
搜索的起始位置，第一次填写空字符串，续拉时填写上一次返回的 UserSearchResult 中的 user_search_result_next_cursor。
用户搜索结果类
消息搜索结果类为 UserSearchResult。参数说明如下：
参数
含义
说明
user_search_result_is_finished
搜索是否已完成
是否已经返回全部满足搜索条件的用户列表。
user_search_result_total_count
搜索结果总数
满足搜索条件的用户总数量。
user_search_result_next_cursor
续拉的游标
调用搜索接口续拉时需要填的游标。
user_search_result_user_list
用户列表
当前一次云端搜索返回的用户列表。
示例代码如下：
UserSearchParam userSearchParam = new UserSearchParam();
userSearchParam.user_search_param_keyword_list = keywordList;
userSearchParam.user_search_param_search_count = 10;
﻿
TencentIMSDK.SearchUsers(userSearchParam, (int code, string desc, UserSearchResult result, string user_data)=>{
 // 处理异步逻辑
});
﻿
﻿

参数	含义	说明
user_search_param_keyword_list	关键字列表	关键字列表最多支持 5 个，keyword 会自动匹配用户 ID、昵称。
user_search_param_keyword_list_match_type	指定关键字列表匹配类型	可设置为 “或” 关系搜索，或 “与” 关系搜索。取值分别为 `TIMKeywordListMatchType_Or` 和 `TIMKeywordListMatchType_And`。默认为 “或” 关系搜索。
user_search_param_gender	用户性别	如果不设置，默认男性和女性都会返回。
user_search_param_min_birthday	用户最小生日	如果不设置，默认值为 0。
user_search_param_max_birthday	用户最大生日	如果不设置，默认 birthday >= minBirthday 的用户都会返回。
user_search_param_search_count	搜索的数量	必须大于 0，最大支持 100，默认 20。
user_search_param_search_cursor	搜索的游标	搜索的起始位置，第一次填写空字符串，续拉时填写上一次返回的 `UserSearchResult` 中的 `user_search_result_next_cursor`。