查询会议成员
- 接口功能
查询会议成员
- 请求地址
https://open.ys7.com/api/service/rtc/conference/participants
- 请求方式
GET
- 请求参数
| 参数位置 | 参数名 | 类型 | 描述 | 是否必选 |
|---|---|---|---|---|
| Header | accessToken | String | 萤石开放API访问令牌 | Y |
| Query | appId | String | 应用ID | Y |
| Query | roomId | String | 房间ID | Y |
-
请求示例
curl --location --request GET 'https://open.ys7.com/api/service/rtc/conference/participants?appId=your_app_id&roomId=your_room_id'
--header 'accessToken: at.xxxxx' -
返回数据
{
"meta": {
"code": "200",
"message": "操作成功",
"moreInfo": null
},
"data": [
{
"nickName": "用户A",
"clientType": 1,
"role": 0,
"avatarUrl": "https://example.com/avatar.png",
"mute": 0,
"muteSys": 0,
"streamMode": 1,
"streamHead": "xxx",
"audio": 1,
"video": 1,
"shareStream": 2,
"customId": "user_001"
}
]
} -
返回字段
| 字段名 | 类型 | 描述 |
|---|---|---|
| meta | Object | 响应元信息 |
| meta.code | String | 状态码 |
| meta.message | String | 错误信息 |
| meta.moreInfo | Object | 更多信息 |
| data | Array<Object> | 会议成员 |
| data.nickName | String | 别名 |
| data.clientType | Int | 客户端类型：1-IOS、3-Android、111-sdpgw、117-录制 |
| data.role | Int | 用户角色，0:主持人;1:联席主持人;2:普通成员;3:设备;4:旁路 |
| data.avatarUrl | String | 头像地址 |
| data.mute | Int | 静音状态：0关闭，1开启 |
| data.muteSys | Int | 系统收音状态：0关闭，1开启 |
| data.streamMode | Int | 大小流模式：具体值以bavClient为准 |
| data.streamHead | String | 流头：具体值以bavClient为准 |
| data.audio | Int | 音频权限是否开启：1-支持，2-不支持 |
| data.video | Int | 视频权限是否开启：1-支持，2-不支持 |
| data.shareStream | Int | 共享流是否开启：1-支持，2-不支持 |
| data.customId | String | 终端ID，开发者分配 |
- 返回码
| 返回码 | 返回消息 | 描述 |
|---|---|---|
| 200 | 操作成功 | |
| 404 | 资源不存在 | |
| 500 | 服务器异常 | |
| 400 | 参数错误 |
萤石致力于成为全球领先的智能视觉物联网服务商，构建了全球领先的视觉物联网云平台，打造了硬件产品+软件云服务一体化的物联网服务体系。萤石云通过构建多数据中心+就近服务点的方式服务于全球客户。截至2025 年底，萤石物联网云平台在全球拥有超过120 个数据站点，平台上的IoT 设备接入数超过3.6 亿，其中视频类设备超过3 亿。在夯实自身平台能力的基础上，萤石进一步开放技术能力，将物联价值延伸至千行百业。萤石开放平台深度融合AI中台能力，涵盖音视频多媒体、消息通知处理、智能算法调度、视频存储备份、ERTC、大数据、物联接入等，已为智慧连锁、智慧养老、文教娱乐、畜牧养殖等42万余位行业客户提供数智化转型升级支撑；萤石物联专有云支持专有化部署，助力中大型企业和组织的数字化转型升级。