controlPTZ:云台控制

功能详情

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

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

请求地址

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

传入参数说明

参数名 参数类型 是否必填 默认值 合法值 参数说明
token String 开发者在账号对接模块获取的Token
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":"lcd08b4b07ce224508",
        "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":"MEGREZ0000001375",
        "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":"操作成功"
    }
}

results matching ""

    No results matching ""