浏览 SDKs · Flutter
SDKsFlutter

搜索群成员

使用 Flutter SDK 在指定群组内搜索成员。

复制

searchGroupMembers() 只搜索一个指定群组。发起请求前应去除关键词首尾空白,不要提交空关键词。

参数说明

参数类型是否必填说明
groupIDString必填目标群组 ID。
keywordListList<String>可选搜索关键词;当前使用第一个非空元素。
isSearchUserIDbool可选是否匹配成员用户 ID。
isSearchMemberNicknamebool可选是否匹配群内昵称。
offsetint可选起始偏移量。
countint可选本次读取数量。
final members = await OpenIM.iMManager.groupManager.searchGroupMembers(
  groupID: groupID,
  keywordList: [keyword.trim()],
  isSearchUserID: true,
  isSearchMemberNickname: true,
  offset: 0,
  count: 50,
);

Future 成功返回当前页匹配的 List<GroupMembersInfo>。关键词或匹配字段变化时应重置 offset。搜索结果只建立快照,不触发成员事件。