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