controlPTZ：云台控制

请求格式

POST JSON 请求体见 请求约定；签名见 签名。

Z

遗留 HTTP 保留： 新接入可使用 云台相对移动（device.service.invoke）对应能力。两套接口不是一对一替代。 registry 没有为本旧方法登记一对一映射。

功能说明

控制设备云台移动、定位、变倍。

请求地址

https://openapi-[DataCenter].easy4ip.com/openapi/controlPTZ

请求参数

注意：TP1设备不支持负角度，故设备型号为TP1时，v不可为负数

请求示例

{
 "system":{
 "ver":"1.0",
 "appId":"lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time":1599027466,
 "nonce":"44299852-e827-46c0-8feb-f373dde79083"
 },
 "id":"21893dda-17b6-418d-9178-e05f31ae79ec",
 "params":{
 "duration":"2000",
 "v":"4",
 "h":"4",
 "z":"0",
 "deviceId":"TESTQWERXXXX",
 "operation":"move",
 "channelId":"0",
 "token": "<yourAccessToken>"
 }
}

operation取值为"move"或者"locate",两种操作不能同时进行。

当operation为move时，表示移动： H 水平移动速度：范围[-8,8]，负数向左，正数向右。 V 垂直移动速度：范围[-8,8]，负数向下，正数向上。 Z 变倍：开放网关 move 时对多数 appId 忽略入参并置 0；零售云等例外以实现为准。立即停止常用 0,0,1（Z 在 move 下仍可能被置 0）。 注意：三个参数为 0,0,1 时表示立即停止。 duration表示移动的持续时间，单位毫秒。没有duration字段或duration字段填“last”表示一直运动下去。

当operation为locate时，表示定位： H 水平位置：取值范围-1~1 V 垂直位置：取值范围-1~1 Z 变倍倍数：归一化0~1，其中0是缩到最小，1表示放到最大。 duration参数无意义，可省略duration字段。

返回 data 字段

无data数据返回

响应示例

{
	"id":"21893dda-17b6-418d-9178-e05f31ae79ec",
	"result":{
		"code":"0",
		"msg":"操作成功"
	}
}

错误码

本接口可能返回下列码；完整分组见 错误码 与 能力错误码。

说明

支持管理员或子账号 accessToken。子账号须在策略中授予对应设备/通道权限，配置见 权限码。 本接口属于旧版协议，无替代。

网关与鉴权（SN / TK / OP）

更多见 错误码 · OP/SN/TK。

子账号（SUB）

更多见 错误码 · SUB。

设备访问与通道（DV10xx）

更多见 错误码 · DV。

收藏点与云台（DV10xx）

说明

支持管理员或子账号 accessToken。子账号须在策略中授予对应设备/通道权限，配置见 权限码。

本接口属于旧版协议，无替代。

相关

• 旧版协议目录

相关参考

• 开发规范
• 公共约定
• 本模块索引