# 声控切换
#### 接口名称
WEB_ConfVoiceCtrlSwitchAPI
#### 功能描述
声控切换时调用该接口。
#### 应用场景
只有主席才能进行该操作，启动（或停止）声控切换，启动声控切换后，声音最大的会场被广播。处理结果由消息MSG_VOICE_SWITCH上报。
#### URL
https://ip/action.cgi?ActionID=WEB_ConfVoiceCtrlSwitchAPI
#### 参数
表1声控切换参数 
| 参数     | 类型     | 取值范围                         | 参数说明                                                                                                                                                                                    |
|:---|:---|:---|:---|
| action | String | {"start", "stop"}            | 表示开始或停止。                                                                                                                                                                                |
| type   | String | {"vct", "api"}               | 智真API："api"，终端："vct"。                                                                                                                                                                   |
| range  | String | {"high", "secondary", "low"} | 表示不同灵敏度(高"high"，中"secondary"，低"low")。                                                                                                                                                   |
| switch | String | {"stop", "site", "screen"}   | "stop" 停止 "site" 按照会场 "screen" 按照屏 |
   
#### 返回值
表2声控切换返回值 
| 参数      | 类型     | 取值范围     | 参数说明                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| success | int    | \[0, 1\] | 响应结果 0：失败 1：成功                                                                                   |
| data    | Object | 可选， 空对象  | 成功返回数据。这里返回空。 例如：{"success":1,"data":""}                                                                                                                                                                                  |
| error   | Object | 可选       | 失败返回错误信息。详细参考[表3]。 例如：{"success":0,"error":{"id":100666117,"code":151031810,"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 对象 | 失败响应的附带参数。                                                                                                              |