外观
获取用户列表
约 246 字小于 1 分钟
2025-03-25
1. 描述
getUserList()
方法用于获取注册到IM服务的用户列表,是一个异步方法
,返回值为Promise
对象。
2. 参数
参数名称 | 是否必选 | 类型 | 说明 |
---|---|---|---|
keywords | 否 | String | 关键词,用于模糊搜索用户昵称或用户名 |
page | 否 | Number | 页码,用于分页获取用户列表,默认为1 |
pageSize | 否 | Number | 每页数量,用于分页获取用户列表,默认为20 |
3. 返回值
返回值为Promise
对象,resolve值为用户列表数组(数组元素结构如下),reject值为错误信息。
字段 | 类型 | 说明 |
---|---|---|
userId | String | 用户ID |
name | String | 用户昵称 |
avatar | String | 用户头像 |
phone | String | 加密后的手机号 |
String | 加密后的邮箱 | |
gender | String | 用户性别,unknown:未知,male:男,female:女 |
updateTime | String | 修改时间 |
createTime | String | 创建时间 |
4. 示例代码
XBCIM.getUserList({
keywords: '张三',
page: 1,
pageSize: 20
}).then(list => {
console.log(list);
}).catch(error => {
console.error(error);
});