• UIKit
  • SDK
  • 服务端 API
Chat/
SDK/
Flutter/
局部搜索/
SDK
  • 安装即时通信 IM SDK
    • 安装
  • 初始化即时通信 IM SDK
    • 初始化
  • 登录和注销
    • 登录和注销
  • 消息
    • 消息概述
    • 发送消息
    • 接收消息
    • 历史消息
    • 转发消息
    • 修改消息
    • 消息插入
    • 删除消息
    • 清空消息
    • 撤回消息
    • 在线消息
    • 已读回执
    • 查询消息
    • 群 @ 消息
    • 定向群消息
    • 通知免打扰
    • 消息扩展
  • 会话
    • 会话概述
    • 会话列表
    • 获取会话
    • 未读会话数
    • 置顶会话
    • 删除会话
    • 会话草稿
    • 会话组
  • 群组
    • 群组概述
    • 群组管理
    • 群资料
    • 群成员管理
    • 群成员资料
    • 自定义群属性
  • 用户
    • 用户资料
    • 好友管理
    • 好友列表
    • 黑名单
  • 离线推送
    • 离线推送
  • 信令
    • 信令管理
  • 局部搜索
    • 查找消息
    • 查找好友
    • 查找群组
    • 查找群成员
  • 接口参考文档
    • 客户接口
  • 开发指引
  • 控制台指南
    • 创建和升级应用
    • 基本配置
    • 功能配置
    • 账号管理
    • 群组管理
    • 回调配置
  • 产品介绍
    • 消息管理
      • 单聊消息
      • 消息存储
      • 离线推送
      • 群消息
      • 消息格式
    • 账号系统
      • 登陆验证
      • 在线状态管理
    • 群相关
      • 群组系统
      • 群组管理
    • 用户资料和关系链
      • 资料管理
      • 关系链管理
  • 购买指南
    • 计费概述
    • 价格中心
  • 错误码

查找好友

功能描述

用户搜索只能搜索本地存储过的用户,例如拉取过的好友列表,拉取过的用户资料等。
说明:
Flutter SDK 3.8.0支持。

搜索本地用户资料

调用接口 searchFriends (点击查看详情) 可以搜索本地用户资料。 您可以设置搜索关键字 keywordList,并指定搜索的范围,即是否搜索用户的 userIDnickNameremark 字段。
示例代码如下:
// 通过关键词搜索好友
//搜索好友的搜索条件
V2TimFriendSearchParam searchParam = V2TimFriendSearchParam(
isSearchNickName: true,//是否搜索昵称
isSearchRemark: true,//是否搜索备注
isSearchUserID: true,//是否搜索id
keywordList: [],//关键字列表,最多支持5个。
);
V2TimValueCallback<List<V2TimFriendInfoResult>> searchFriendsRes =
await TencentImSDKPlugin.v2TIMManager
.getFriendshipManager()
.searchFriends(searchParam: searchParam); //搜索好友的搜索条件
if (searchFriendsRes.code == 0) {
// 查询成功
searchFriendsRes.data?.forEach((element) {
element.relation; //好友类型 0:不是好友 1:对方在我的好友列表中 2:我在对方的好友列表中 3:互为好友
element.resultCode; //此条记录的查询结果错误码
element.resultInfo; //此条查询结果描述
//friendInfo为好友个人资料,如果不是好友,除了 userID 字段,其他字段都为空
element.friendInfo
?.friendCustomInfo; //好友自定义字段 首先要在 控制台 (功能配置 -> 好友自定义字段) 配置好友自定义字段,然后再调用接口进行设置
element.friendInfo?.friendGroups; //好友所在分组列表
element.friendInfo?.friendRemark; //好友备注
element.friendInfo?.userID; //用户的id
element.friendInfo?.userProfile
?.allowType; //用户的好友验证方式 0:允许所有人加我好友 1:不允许所有人加我好友 2:加我好友需我确认
element.friendInfo?.userProfile?.birthday; //用户生日
element.friendInfo?.userProfile?.customInfo; //用户的自定义状态
element.friendInfo?.userProfile?.faceUrl; //用户头像 url
element.friendInfo?.userProfile?.gender; //用户的性别 1:男 2:女
element.friendInfo?.userProfile?.level; //用户的等级
element.friendInfo?.userProfile?.nickName; //用户昵称
element.friendInfo?.userProfile?.role; //用户的角色
element.friendInfo?.userProfile?.selfSignature; //用户的签名
element.friendInfo?.userProfile?.userID; //用户 ID
});
}