DescribeUserList

接口原型参数

https://rtc-api.zego.im?Action=DescribeUserList

💡公共参数。AppId，ZEGO 分配的用户唯一凭证。

💡公共参数。随机字符串。

💡公共参数。Unix 时间戳，单位为秒。最多允许 10 分钟的误差。

💡公共参数。签名，用于验证请求的合法性。

💡公共参数。签名版本号。

💡公共参数。是否为测试环境。设为 true 表示使用测试环境。2021-11-16 及之前在 ZEGO 控制台创建的项目默认是测试环境，可根据业务需求设置此参数；而之后创建的项目默认是正式环境。

房间 ID。房间不存在会返回空列表。

用户登录房间的时间排序，默认值为 0。0：按时间正序 1：按时间倒序

单次请求返回的用户个数，取值范围 0-200，即调用本接口一次最多返回 200 个用户。房间内人数超过 200 时，需要根据前一次调用本接口时、返回结果中的 Marker（用户起始位标识）取值，再次调用本接口查询其余用户。

例如，房间内有 450 个用户，调用本接口查询用户列表时：

• (1) 第一次调用本接口，入参 Marker 传空，查询第 1 ～ 200 的用户；返回结果中 Marker 值假设为 “marker1”。
• (2) 第二次调用本接口，入参 Marker 取值为 “marker1”，查询第 201 ～ 400 的用户；返回结果中 Marker 值假设为 “marker2”。
• (3) 第三次调用本接口，入参 Marker 取值为 “marker2”，查询第 401 ～ 450 的用户；查询完毕，返回结果中 Marker 为空。

查询用户起始位标识，每次请求的响应有返回，为空时从头开始返回用户信息。