SDKsReact Native

搜索群成员

在指定群组中搜索成员。

在指定群组中按用户 ID 或群内昵称关键词搜索匹配的群成员。

const members = await OpenIMSDK.searchGroupMembers({
  groupID: 'group-001',
  keywordList: ['张'],
  isSearchUserID: false,
  isSearchMemberNickname: true,
  offset: 0,
  count: 50,
});

参数说明

参数	类型	必填	含义
`groupID`	`string`	是	目标群组 ID。
`keywordList`	`string[]`	是	搜索关键词列表。
`isSearchUserID`	`boolean`	是	是否匹配用户 ID。
`isSearchMemberNickname`	`boolean`	是	是否匹配群内昵称。
`offset`	`number`	是	分页偏移量，第一页传 `0`。
`count`	`number`	是	本次读取的成员数量。

返回结果

调用完成后返回当前页匹配的 GroupMemberItem[]。返回数量少于 count 时表示已拉取到最后一页；客户端在展示或合并搜索结果时，应使用复合标识 groupID:userID 唯一区分每位成员。各字段详细说明见群组概览。

这个页面有帮助吗？