按会议查询参会终端网络数据

查询会中参会人终端网络质量相关数据(上行/下行音视频指标等)。

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"
}