按会议查询参会终端网络数据
查询会中参会人终端网络质量相关数据(上行/下行音视频指标等)。
1. 接口描述
接口名称:
/confopenapi/conference/attendee/listofnet
发送方式:
POST
参数格式:
accept: application/json; content-type: application/json
2. 输入参数
Http Header
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| token | 否 | string | 鉴权 token;可与 HttpBody 中的 token 二选一或同时传递,与「按会议查询参会终端列表」等接口一致 |
HttpBody
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| eventId | 是 | long | 会议预约 ID(日历活动 ID)。支持 JSON 数字类型 |
| serviceType | 否 | int | 业务服务类型 1:音频 2:视频 |
| page | 否 | int | 页码,从 1 开始;默认 1 |
| count | 否 | int | 每页条数;默认 20 |
| keyword | 否 | string | 参会者姓名关键字筛选 |
3. 请求示例
{
"eventId": 1165158,
“serviceType”:1
}
4. 返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| status | int | 业务状态码;0 一般为成功;与 RTSAS 返回的 code 一致;非 0 表示失败或业务异常 |
| result | json | 业务数据,见下表 |
| msg | string | 提示信息 |
| request_id | string | 请求 ID;若 RTSAS 返回 request_id 则会回写 |
| timestamp | long | 时间戳(毫秒) |
| request_duration | string | 服务端处理耗时 |
result 参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| list | array | 参会终端网络数据列表,元素结构见「list 单项说明」 |
list 单项说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| eventId | long | 预约会议 ID |
| conferenceId | string | 会议 ID |
| tempUserId | long | 参会端 临时用户ID |
| customerCode | string | 客户编码 |
| name | string | 姓名 |
| role | int | 角色 |
| roles | array | 角色 ID 列表 |
| timestamp | int | 时间戳(含义与 RTSAS 一致) |
| audioUp | object | 上行音频指标,见「音视频指标对象」;无数据时为 null |
| audioDown | object | 下行音频指标 |
| videoUp | object | 上行视频指标 |
| videoDown | object | 下行视频指标 |
| umsId | long | UMS 用户 ID |
| onlineTime | long | 上线时间,Unix 秒 |
音视频指标对象(audioUp / audioDown / videoUp / videoDown)
音频对象字段:
| 参数名 | 类型 | 说明 |
|---|---|---|
| rtt | int | 往返时延 |
| jitter | int | 抖动 |
| lostrate | int | 丢包率 |
| maxLostrate | int | 最大丢包率 |
视频对象在音频字段基础上增加:
| 参数名 | 类型 | 说明 |
|---|---|---|
| fps | int | 帧率 |
| ppi | string | 分辨率等展示信息 |
返回示例
{
"status": 0,
"result": {
"list": [
{
"confId": 22188557,
"uid": "abc123",
"customerCode": "990001",
"name": "李四",
"role": 0,
"roles": [1, 2],
"timestamp": 0,
"audioUp": {
"rtt": 10,
"jitter": 2,
"lostrate": 0,
"maxLostrate": 1
},
"audioDown": null,
"videoUp": {
"rtt": 12,
"jitter": 1,
"lostrate": 0,
"maxLostrate": 0,
"fps": 30,
"ppi": "1920x1080"
},
"videoDown": null,
"umsId": 10002,
"onlineTime": 1715600000
}
]
},
"msg": "success",
"request_id": "confopenapiserver-172371014-1774514768.581757447.258",
"timestamp": 1774514768581,
"request_duration": "45.2ms"
}


