视频监控 > API 文档 > PTZ相关接口 > 云台控制

云台控制

最近更新时间: 2022-11-28 16:22:18

本接口用于对摄像头进行转动镜头，如水平、垂直、缩放等操作

接口请求域名：qvs.qiniuapi.com
请求方式：POST
接口路径：/v1/namespaces/{namespaceId}/devices/{deviceId}/ptz
Tips: 请求参数中的cmd字段设置为stop时, 设备才会停止；否则会永不停歇

请求参数

路径参数

参数名称	必填	字段类型	说明
namespaceId	是	string	空间ID
deviceId	是	string	设备国标Id

Body

参数名称	必填	字段类型	说明
cmd	是	string	left(向左), right(向右), up(向上), down(向下), leftup(左上), rightup(右上), leftdown(左下), rightdown(右下), zoomin(放大), zoomout(缩小),stop(停止PTZ操作)
speed	是	int	调节速度(1~10, 默认位5)
chId	否	string	如果设备是普通摄像头，该字段置空字符串即可，如果设备是平台类型，该字段为子设备国标ID

响应参数

200

请求示例

curl --request POST \
  --url http://qvs.qiniuapi.com/v1/namespaces/2akrarxtmpned/devices/31011500991320000137/ptz \
  --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc=' \
  --header 'content-type: application/json' \
  --data '{
	"cmd":"left",
	"speed":1
}'

响应示例

{
  "code": 200
}

以上内容是否对您有帮助？