云平台控制

controlPTZ：云台控制

功能详情

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

注意：需要设备具有云台控制相关的能力集，具体详见设备能力集说明

请求地址

https://openapi.lechange.cn/openapi/controlPTZ

传入参数说明

参数名	参数类型	是否必填	合法值	参数说明
token	String	是		管理员accessToken
deviceId	String	是		设备序列号
channelId	String	是		通道号
operation	String	是	"move"、"locate"	操作类型"move"：移动操作 "locate"：定位操作
h	Double	是	operation=move时，取[-8,8]；operation=locate时，取[-1,1]	水平操作参数
v	Double	是	operation=move时，取[-8,8]；operation=locate时，取[-1,1]	垂直操作参数
z	Double	是	operation=move时，z值无限制；operation=locate时，取[0,1]	变倍参数
duration	String	否	"last"或者毫秒值	operation="move"时有意义：表示移动持续时间，单位毫秒，没有operation字段或operation字段填“last”表示一直运动下去。

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

样例输入

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

operation取值为"move"或者"locate",两种操作不能同时进行。
当operation为move时，表示移动： H 水平移动速度：范围[-8,8]，负数向左，正数向右。 V 垂直移动速度：范围[-8,8]，负数向下，正数向上。 Z 变倍倍数：范围无限制。注意：三个参数为 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":"操作成功"
	}
}