浏览 SDKs · Android
平台
SDKsAndroid

搜索好友

通过关键词本地搜索当前用户的好友。

复制

在当前登录用户的好友数据库中执行本地模糊搜索,支持按用户 ID、昵称和备注名匹配好友。

OpenIMClient.getInstance().friendshipManager.searchFriends(
    new OnBase<List<FriendInfo>>() {
        @Override
        public void onSuccess(List<FriendInfo> results) {
            // 使用 results 显示搜索结果
        }

        @Override
        public void onError(int code, String error) {
            // 处理错误
        }
    },
    Collections.singletonList(keyword.trim()),
    true,
    true,
    true
);

参数说明

参数类型是否必填说明
baseOnBase<List<FriendInfo>>是异步请求回调。
keywordListList<String>是搜索关键词列表,通常传入单个非空搜索词。
isSearchUserIDboolean是是否匹配好友的用户 ID。
isSearchNicknameboolean是是否匹配好友的昵称。
isSearchRemarkboolean是是否匹配设置的好友备注名。

注意三个搜索开关至少需要将其中一项设为 true。

返回结果

成功回调返回匹配到的 List<FriendInfo> 列表。客户端应以 userID 为主键对搜索结果进行去重与展示;若未命中任何好友,返回空列表。