即时通信 IM Unity(搜索用户)

可以以通过用户 ID、昵称、性别等信息来搜索云端用户,以便快速找到所需的用户资料。此功能适用于需要查找特定用户信息的场合,例如在熟人社交场景中查找用户以加好友,或者在陌生人社交场景中查找用户以关注。

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

一、功能描述

注意:说明:

二、搜索云端用户接口

调用接口 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)=>{ // 处理异步逻辑});

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