云通訊平臺為開發者提供了服務器錄音錄像接口,通過調用接口可以實現點對點音視頻和音視頻會議的錄音錄像功能。服務器錄音錄像相關接口包括點對點音視頻開始錄制和停止錄制,視頻會議開始錄制和停止錄制,以及音頻會議開始錄音和停止錄音接口。
視頻錄像功能目前只支持音頻編碼PCMU,視頻編碼H264或VP8的編碼格式。如需錄像功能,需要在發起呼叫前調用SDK相關接口設置編碼格式。
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.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.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日