添加预置位
更新时间：2022-02-17
接口描述
本接口用于对国标设备通道进行添加预置位。
预置位是将被监视的重点区域与球机的运行状况联系在一起的方式。当云台运行到需要重点监视的地方，向球机发出设置预置点的命令，球机则将此时的云台的方位和摄像机的状态记录下来，并与该预置点的号码联系起来。当向球机发出召回（calling）命令时，云台立即以最快的速度运行到该点，摄像机也回到当时记忆的状态，从而方便监控人员能迅速地查看被监视领域。
请求（Request）
请求URI
POST /v1/device/channel/{channenId}/preset
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| channelId | Long | 是 | 国标设备通道ID |
注意： 发起添加预置位请求前，确保已经通过ptz控制，将摄像机调整到预期的方位和角度。
请求头域
除公共头域外，无其它特殊头域。
请求体
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| name | String | 是 | 预置位名称，最大长度100 |
响应（Response）
响应头域
除公共头域外，无其它特殊头域。
响应体
| 参数名称 | 类型 | 描述 |
|---|---|---|
| presetId | Integer | 预置位ID |
示例
请求示例
POST /v1/device/channel/1000001/preset HTTP/1.1
x-bce-date: 2020-03-25T09:28:13Z
host: evs.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
{
"name": "海淀小学大门东南角方向东"
}响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 202 013:34:07 GMT
Content-Type: application/json;charset=UTF-8
{
"presetId": 1
}错误码
| 错误码（code） | 消息（message) | 描述 | HTTP状态码 |
|---|---|---|---|
| DeviceOperationNotPermitted | sip_preset not permitted for device status: XXX | 当前设备状态不允许进行预置位操作 | 403 |