浏览 SDKs · WASM
SDKsWASM

搜索群成员

在指定群组中搜索成员。

复制

searchGroupMembers() 适合搜索成员或获取 @ 候选人。当前接口只使用 keywordList 的第一个关键词。

参数说明

参数类型是否必填说明
groupIDstring目标群组 ID。
keywordListstring[]搜索关键词数组。
isSearchUserIDboolean是否匹配用户 ID。
isSearchMemberNicknameboolean是否匹配群内昵称。
offsetnumber分页偏移量,首页传 0
countnumber本次请求的成员数量。
const { data: members } = await openimsdk.searchGroupMembers({
  groupID,
  keywordList: [keyword.trim()],
  isSearchUserID: true,
  isSearchMemberNickname: true,
  offset: 0,
  count: 50,
});

Promise 成功后,data 是当前页匹配的 GroupMemberItem[],字段含义见分页查询群成员。搜索结果只用于当前关键词下的成员快照,不应替换完整成员列表。

关键词或筛选条件变化时重置分页。