ONVIF设备PTZ操作
更新时间：2022-02-17
接口描述
本接口用于对ONVIF设备通道进行PTZ操作。
PTZ在安防监控应用中是 Pan/Tilt/Zoom 的简写，代表国标摄像机全方位（左右/上下）移动及镜头变倍、变焦控制。
请求（Request）
请求URI
PUT /v1/device/onvif/{channelId}?ptz&ptzCommand={ptzCommand}&step={step}
| 参数名称 | 类型 | 是否必需 | 描述 |
|---|---|---|---|
| channelId | Long | 是 | 通道ID |
| ptzCommand | String | 是 | ptz命令，支持left/right/up/down/zoomin/zoomout/left_up/left_down/right_up/right_down |
| step | Double | 是 | 移动角度，取值范围[0:1] |
注意： left：左，right：右，up：上，down：下，zoomin：放大倍数，zoomout：缩小倍数，left_up：左上，left_down：左下，right_up：右上，right_down：右下。
请求头域
除公共头域外，无其它特殊头域。
请求体
无
响应（Response）
响应头域
除公共头域外，无其它特殊头域。
响应体
无
示例
请求示例
PUT /v1/device/onvif/1000001?ptz&ptzCommand=up&speed=255 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响应示例
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错误码
| 错误码（code） | 消息（message) | 描述 | HTTP状态码 |
|---|---|---|---|
| DeviceOperationNotPermitted | sip_ptz not permitted for device status: XXX | 当前设备状态不允许进行ptz操作 | 403 |