服务器录音录像
云通讯平台为开发者提供了服务器录音录像接口，通过调用接口可以实现点对点音视频和音视频会议的录音录像功能。服务器录音录像相关接口包括点对点音视频开始录制和停止录制，视频会议开始录制和停止录制，以及音频会议开始录音和停止录音接口。
视频录像功能目前只支持音频编码PCMU，视频编码H264或VP8的编码格式。如需录像功能，需要在发起呼叫前调用SDK相关接口设置编码格式。
1、点对点音频视频录制
1.1、开始录制
1.1.1、请求地址
POST/{SoftVersion}/Application/{appId}/call/transmission?sig={SigParameter}&type=2&mode=1&sign=1
注：type：1 录音 2 录像; mode和sign固定为1。
1.1.2、请求包头
请参阅《鉴权说明》
1.1.3、请求包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| callSid | String | 必选 | 呼叫id，平台侧为每个呼叫分配唯一id。通过SDK接口获取服务器callSid，具体方法参考：Android方法点击>>IOS方法点击>> |
1.1.4、XML请求示例
POST/2013-12-26/Application/abcdefghijklmnopqrstuvwxyz123456/call/transmission?
sig=155EAA68C5DFB6B762A42D88F406ABCD&type=2&mode=1&sign=1
HTTP/1.1
Host: 192.168.0.1:8883
Accept:application/xml;
Content-Type:application/xml;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDE=
{"callSid":"170712160603798600010069000316e3"}
1.1.5、响应包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| statusCode | String | 必选 | 请求状态码，取值000000（成功） |
| statusMsg | String | 必选 | 请求状态码，取值success |
1.1.6、XML响应示例
HTTP/1.1 200 OK
Content-Length: 641
{"statusCode":"000000","statusMsg":"success"}
1.2、停止录制
1.2.1、请求地址
POST/{SoftVersion}/Application/{appId}/call/transmission?sig={SigParameter}&type=2&mode=1&sign=2
注：type：1 录音 2 录像; mode固定为1; sign固定为2。
1.2.2、请求包头
请参阅《鉴权说明》
1.2.3、请求包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| callSid | String | 必选 | 呼叫id，平台侧为每个呼叫分配唯一id。通过SDK接口获取服务器callSid，具体方法参考：Android方法点击>>IOS方法点击>> |
1.2.4、XML请求示例
POST/2013-12-26/Application/abcdefghijklmnopqrstuvwxyz123456/call/transmission?
sig=155EAA68C5DFB6B762A42D88F406ABC&type=2&mode=1&sign=2
HTTP/1.1
Host: 192.168.0.1:8883
Accept:application/xml;
Content-Type:application/xml;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDE=
{"callSid":"170712160603798600010069000316e3"}
1.2.5、响应包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| statusCode | String | 必选 | 请求状态码，取值000000（成功） |
| statusMsg | String | 必选 | 请求状态码，取值success |
1.1.6、XML响应示例
HTTP/1.1 200 OK
Content-Length: 641
HTTP/1.1 200 OK
Content-Length: 641
{"statusCode":"000000","statusMsg":"success"}
2、视频会议录制
2.1、开始录制
2.1.1、请求地址
POST/{SoftVersion}/Application/{appId}/call/transmission?sig={SigParameter}&type=2&mode=2&sign=1
注：type：1 录音 2 录像; mode固定为2; sign固定为1。
2.1.2、请求包头
请参阅《鉴权说明》
2.1.3、请求包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| confid | String | 必选 | 会议ID |
2.1.4、请求示例
POST/2013-12-26/Application/abcdefghijklmnopqrstuvwxyz123456/call/transmission?
sig=155EAA68C5DFB6B762A42D88F406ABC&type=2&mode=2&sign=1
HTTP/1.1
Host: 192.168.0.1:8883
Accept:application/xml;
Content-Type:application/xml;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDE=
{"confId":"conf12345678"}
2.1.5、响应包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| statusCode | String | 必选 | 请求状态码，取值000000（成功） |
| statusMsg | String | 必选 | 请求状态码，取值success |
2.1.6、XML响应示例
HTTP/1.1 200 OK
Content-Length: 641
HTTP/1.1 200 OK
Content-Length: 641
{"statusCode":"000000","statusMsg":"success"}
2.2、视频会议停止录制
2.2.1、请求地址
POST/{SoftVersion}/Application/{appId}/call/transmission?sig={SigParameter}&type=2&mode=2&sign=2
注：type：1 录音 2 录像; mode和sigin固定为2。
2.2.2、请求包头
请参阅《鉴权说明》
2.2.3、请求包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| ConfStopVideoRecord | String | 必选 | 视频会议停止录像主节点 |
| confid | String | 必选 | 会议ID |
2.2.4、XML请求示例
POST/2013-12-26/Application/abcdefghijklmnopqrstuvwxyz123456/call/transmission?
sig=155EAA68C5DFB6B762A42D88F406ABC&type=2&mode=2&sign=2
HTTP/1.1
Host: 192.168.0.1:8883
Accept:application/xml;
Content-Type:application/xml;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDE=
{"confid":"8002"}
2.2.5、响应包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| statusCode | String | 必选 | 请求状态码，取值000000（成功） |
| statusMsg | String | 必选 | 请求状态码，取值success |
2.2.6、XML响应示例
HTTP/1.1 200 OK
Content-Length: 641
HTTP/1.1 200 OK
Content-Length: 641
{"statusCode":"000000","statusMsg":"success"}
3、音频会议录音
3.1、开始录音
3.1.1、请求地址
POST/{SoftVersion}/Application/{appId}/call/transmission?sig={SigParameter}&type=1&mode=2&sign=1
注：type固定为1; mode固定为2; sign固定为1。
3.1.2、请求包头
请参阅《鉴权说明》
3.1.3、请求包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| ConfRecord | String | 必选 | 音频会议开始录音主节点 |
| confid | String | 必选 | 会议ID |
3.1.4、XML请求示例
POST/2013-12-26/Application/abcdefghijklmnopqrstuvwxyz123456/call/transmission?
sig=155EAA68C5DFB6B762A42D88F406ABC&type=1&mode=2&sign=1 HTTP/1.1
Host: 192.168.0.1:8883
Accept:application/xml;
Content-Type:application/xml;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDE=
{"confid":"8002"}
3.1.5、响应包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| statusCode | String | 必选 | 请求状态码，取值000000（成功） |
| statusMsg | String | 必选 | 请求状态码，取值success |
3.1.6、XML响应示例
HTTP/1.1 200 OK
Content-Length: 641
HTTP/1.1 200 OK
Content-Length: 641
{"statusCode":"000000","statusMsg":"success"}
3.2、音频会议停止录音
3.2.1、请求地址
POST/{SoftVersion}/Application/{appId}/call/transmission?sig={SigParameter}&type=1&mode=2&sign=2
注：type固定为1; mode和sigin固定为2。
3.2.2、请求包头
请参阅《鉴权说明》
3.2.3、请求包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| ConfStopRecord | String | 必选 | 视频会议停止录像主节点 |
| confid | String | 必选 | 会议ID |
2.2.4、XML请求示例
POST/2013-12-26/Application/abcdefghijklmnopqrstuvwxyz123456/call/transmission?
sig=155EAA68C5DFB6B762A42D88F406ABC&type=1&mode=2&sign=2
HTTP/1.1
Host: 192.168.0.1:8883
Accept:application/xml;
Content-Type:application/xml;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDE=
{"confid":"8002"}
3.2.5、响应包体
| 属性 | 类型 | 约束 | 说明 |
|---|---|---|---|
| statusCode | String | 必选 | 请求状态码，取值000000（成功） |
| statusMsg | String | 必选 | 请求状态码，取值success |
3.2.6、XML响应示例
HTTP/1.1 200 OK
Content-Length: 641
HTTP/1.1 200 OK
Content-Length: 641
{"statusCode":"000000","statusMsg":"success"}
文档更新时间：2017年12月26日