本地会场接听或挂断来电
接口名称
WEB_IncomingCallProcAPI
功能描述
本地会场接听或挂断来电时调用该接口,来电通过消息MSG_START_CALL上报。挂断来电成功失败通过消息MSG_DISCONNECT_CALL上报。会场句柄用来区分每个会场。
应用场景
远端有来电时,本地会场接听或挂断来电。当同时有多路来电时,可以选择接听或挂断其中的某一路或某几路。另外,在SIP点对点通话中,远端请求视频通话时,本地会场接受或拒绝,也是通过该接口。
URL
https://ip/action.cgi?ActionID=WEB_IncomingCallProcAPI
参数
| 参数 | 类型 | 取值范围 | 参数说明 |
|---|---|---|---|
| ucValue | int | [0, 1] | ucValue表示接听或拒绝 1:接听 0:拒绝 |
| ucMediaType | int | [0, 1] | 请求类型 0:普通呼叫 1:SIP通话中音频升视频 |
| ucSiteHandle | int | [0, 255] | 会场句柄 |
返回值
| 参数 | 类型 | 取值范围 | 参数说明 |
|---|---|---|---|
| success | int | [0, 1] | 响应结果 0:失败 1:成功 |
| data | Object | 可选, 空对象 | 成功返回数据。这里返回空。 例如:{"success":1,"data":""} |
| error | Object | 可选 | 失败返回错误信息。详细参考表3。 例如:{"success":0,"error":{"id":100666995,"code":33558532,"params":[]}} |
| 参数 | 类型 | 取值范围 | 参数说明 |
|---|---|---|---|
| id | int | 32位整数 | 错误id,用于转换。 |
| code | int | 32位整数 | 错误码,跟错误id对应,具体含义参考错误码。 |
| param | Object | param 对象 | 失败响应的附带参数。 |