# 录制多方协同会议（API名称：captureConferenceVideo）
#### 功能介绍
用于用户系统录制多方协同会议。
#### 相关API
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### URL
| **请求方式** | **HTTPS地址**                                                                     | **服务架构** | **消息体类型**        |
|:---|:---|:---|:---|
| POST     | https://***isdp+域名***/openapi/v1/openApiCreateConference/captureConferenceVideo | OpenAPI  | application/json |
   
#### 请求头
| **KEY**       | VALUE                  | 是否必填 | **描述**                                                                                           |
|:---|:---|:---|:---|
| Content-Type  | application/json       | 是    | 无                                                                                                |
| Authorization | bearer ${access_token} | 是    | bearer +" "+[5.2.1](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的access_token的值 |
   
#### 请求参数
| 参数                         | 类型             | 是否必填 | 描述                     |
|:---|:---|:---|:---|
| liveMeetingId              | Long           | 是    | 会议id                   |
| chairId                    | Long           | 否    | 主持人id(如果不设置，默认是当前登录用户) |
| channelId                  | String         | 是    | 频道id                   |
| uidList                    | int            | 是    | 指定录制的用户                |
| meetingUsers               | List\<Object\> | 是    | 与会者                    |
| meetingUsers .userName     | String         | 是    | 与会者名称                  |
| meetingUsers .userId       | Long           | 是    | 用户id                   |
| meetingUsers .role         | int            | 是    | 角色                     |
| meetingUsers .isdpDeviceId | String         | 否    | 设备id                   |
| layoutMode                 | int            | 是    | 混流布局 （多人会议录制值：1）       |
   
#### 响应参数
| 参数                     | 类型      | 描述                  |
|:---|:---|:---|
| status                 | String  | 接口响应编码，1成功，非1失败     |
| hasError               | boolean | 是否有误                |
| errorMsg               | String  | 接口错误提示信息。           |
| data                   | Object  | 响应结果                |
| data.recordingId       | String  | 录制id                |
| data.businessCode      | String  | 业务code              |
| data.channelName       | String  | 频道名称                |
| data.recordingUid      | String  | 录制的用户id             |
| data.recordingType     | int     | 录制方式,0:视频,1:截帧,2:音频 |
| data.recordingStatus   | int     | 录制状态                |
| data.recordingFilePath | String  | 录制文件路径              |
| data.videoStorageType  | String  | 存储类型                |
   
#### 请求示例
```
{
"liveMeetingId":3604,"channelId":"339520611831877","uidList":[179357],"meetingUsers":[{"userName":"fc001","userId":131295,"role":1,"isdpDeviceId":null}],"layoutMode":1,"chairId":215717
}
```
#### 响应示例
```
{
"hasError": false,
    "errorMsg": null,
    "data": {
        "recordingId": "202210061133085449",
        "businessCode": "HELMET_MULTI_CONFERENCE",
        "channelId": "339520611831877",
        "channelName": "helmet_multi_conference_3604",
        "recordingUid": "179357",
        "recordingType": 0,
        "recordingStatus": 1,
        "recordingFilePath": "20221006/339520611831877/1133082500/",
        "recordingHost": null,
        "beginTime": "2022-10-06T03:33:08.250+00:00",
        "endTime": null,
        "videoFileName": null,
        "videoMergeFile": null,
        "videoBucketName": null,
        "videoStorageType": "OBS",
        "createdBy": 131295,
        "creationDate": "2022-10-06T03:33:08.000+00:00",
        "lastUpdatedBy": null,
        "lastUpdateDate": "2022-10-06T03:33:08.000+00:00"
    },
    "errorCode": null,
    "status": 1,
    "message": "SUCCESS"
}
```