SDKsWASM
搜索群成员
在指定群组中搜索成员。
searchGroupMembers() 适合搜索成员或获取 @ 候选人。当前接口只使用 keywordList 的第一个关键词。
参数说明
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
groupID | string | 是 | 目标群组 ID。 |
keywordList | string[] | 是 | 搜索关键词数组。 |
isSearchUserID | boolean | 是 | 是否匹配用户 ID。 |
isSearchMemberNickname | boolean | 是 | 是否匹配群内昵称。 |
offset | number | 是 | 分页偏移量,首页传 0。 |
count | number | 是 | 本次请求的成员数量。 |
const { data: members } = await openimsdk.searchGroupMembers({
groupID,
keywordList: [keyword.trim()],
isSearchUserID: true,
isSearchMemberNickname: true,
offset: 0,
count: 50,
});Promise 成功后,data 是当前页匹配的 GroupMemberItem[],字段含义见分页查询群成员。搜索结果只用于当前关键词下的成员快照,不应替换完整成员列表。
关键词或筛选条件变化时重置分页。
这个页面有帮助吗?