本地会场接听或挂断来电
接口名称
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 对象 |
失败响应的附带参数。 |