乐橙云开发文档
快速入门
  • 文档综述
  • 云直播开发指南
  • 轻应用开发指南
  • 移动应用开发指南
  • 桌面应用开发指南
  • 消息推送
  • 云转存
  • 国标GB28181设备接入
  • HTTP接口
  • 服务支持
前往官网
快速入门
  • 文档综述
  • 云直播开发指南
  • 轻应用开发指南
  • 移动应用开发指南
  • 桌面应用开发指南
  • 消息推送
  • 云转存
  • 国标GB28181设备接入
  • HTTP接口
  • 服务支持
前往官网
快速入门
  • 文档综述

  • 云直播开发指南

  • 轻应用开发指南

  • 小程序对接指南

  • 移动应用开发指南

  • 桌面应用开发指南

  • 消息推送

  • 云转存

  • 国标GB28181设备接入

  • IOT物模型

  • HTTP接口

    • API隐私协议
    • 开发规范
    • Postman按接口模拟调用教程
    • accessToken:获取管理员token
    • 设备

    • 账户对接

    • 推送配置

    • 云存储服务

    • AI服务

    • 设备能力集
    • 设备能力开关
    • 接口调用限制说明
    • 全局返回码说明
    • 云平台能力说明
    • 旧版本协议(后续不再维护)

      • 旧版协议说明
      • 云平台控制
        • controlPTZ:云台控制
          • 功能详情
          • 请求地址
          • 传入参数说明
          • 样例输入
          • 返回data字段说明
          • 样例输出
      • 获取设备列表
      • 单个设备信息获取
      • 根据设备序列号获取多个设备信息
      • 单个设备通道的详细信息获取
      • 获取设备版本和可升级信息
      • 分页获取开放平台添加设备的通道基本信息
      • 获取开放平台添加设备的通道基本信息
      • 批量获取设备的详细信息
      • 分页获取乐橙app添加或分享的设备通道基本信息
      • 获取乐橙app添加或分享设备的通道基本信息
      • 批量获取乐橙app添加或分享的设备详细信息
      • 分页获取乐橙app分享给开发者设备列表
      • 批量获取多个设备通道以及配件的能力集
      • 获取子账号下指定的授权设备详细信息
      • 分页获取子账号下授权设备的详细信息
      • 获取呼吸灯状态
      • 设置呼吸灯开关
      • 设置设备本地录像计划
  • 服务支持

本页目录

云平台控制

# 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"
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

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":"操作成功"
	}
}
1
2
3
4
5
6
7
旧版协议说明
获取设备列表
意见反馈
您的改进建议

鼠标选中内容,快速反馈问题

选中存在疑惑的内容,即可快速反馈问题,我们将尽快跟进处理。

不再提示 好的,我知道了

企业微信
企业微信二维码

扫码添加企业微信

在线沟通乐橙云对接方案及费用问题

  • 浅色模式
  • 深色模式
  • 阅读模式
您的改进建议
商务咨询