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

查找群成员

功能描述

群成员搜索只能搜索本地存储过的群成员,例如拉取过的群成员列表、拉取过的群成员资料等。
说明:
flutter sdk 3.8.0支持,直播群(AVChatRoom)不在本地存储群成员,无法使用群成员搜索功能。

搜索本地群组

您可以调用接口 searchGroupMembers (点击查看详情) 搜索本地群成员。 您可以设置搜索关键字 keywordList,并指定搜索的范围,即是否搜索群成员的 memberUserIDmemberNickNamememberRemarkmemberNameCard 字段。
根据 searchGroupMembers 入参 V2TIMGroupMemberSearchParam (点击查看详情) 中的 groupIDList 是否为空(null/nil),分为两种情况:
如果设置 groupIDList 为空,代表搜索全部群中的群成员,返回的结果会按照 groupID 进行分类;
如果设置 groupIDList 不为空,代表搜索指定群中的群成员。
示例代码如下:
//搜索参数设置
V2TimGroupMemberSearchParam param = V2TimGroupMemberSearchParam(
groupIDList: [],// 指定群 ID 列表,若为 null 则搜索全部群中的群成员
isSearchMemberNameCard: true,// 设置是否搜索群成员名片,默认为true
isSearchMemberRemark: true,// 设置是否搜索群成员备注,默认为true
isSearchMemberNickName: true,// 设置是否搜索群成员昵称,默认为true
isSearchMemberUserID: true,// 设置是否搜索群成员 userID,默认为true
keywordList: []);// 搜索关键字列表,最多支持5个
//搜索群成员
V2TimValueCallback<V2GroupMemberInfoSearchResult> searchGroupMembersRes =
await TencentImSDKPlugin.v2TIMManager
.getGroupManager()
.searchGroupMembers(param: param); // 搜索群成员的搜索参数
if (searchGroupMembersRes.code == 0) {
// 搜索成功
searchGroupMembersRes.data?.groupMemberSearchResultItems;// 群成员搜索结果
}