备案 控制台 登录 注册
文档中心 > 开启云控制台PTZ控制
开启云控制台PTZ控制

最近更新时间：2022-07-28

1、功能介绍

  • 云控制台摄像头方向、变倍、焦距、光圈控制。

  • 点动模式下，云台转动固定步长后自动停止转动。

  • 连续移动模式下，云台会持续转动，直到收到云台停止命令。

  • Pan，Tilt，Zoom，Iris，Focus 至少有一个传参。

  • Pan、Tilt支持同时设置，但Zoom、Iris、Focus只支持单独设置。

2、请求参数

参数

是否必选

参数类型

描述

Action是StringStartCloudDevicePtz

DeviceId

是

String

设备ID

Mode是Integer云台控制模式。取值：0（点动模式），1（连续移动模式）
Pan否Integer

云台水平转动速度参数，正值表示向左水平转动，负值表示向右水平转动。
取值：-100~100 , 且不能为0(可与tilt同时使用，表示斜着转)

Tilt否Integer云台垂直转动速度参数，正值表示向上垂直转动，负值表示向下垂直转动。
取值：-100~100, 且不能为0 (可与pan同时使用，表示斜着转)
Zoom否Integer云台缩放速度参数，正值表示放大，负值表示缩小。
取值：-100~100, 且不能为0
Iris否Integer光圈速度参数，正值表示光圈变大，负值表示光圈缩小。
取值：-100~100, 且不能为0
Focus否Integer变焦速度参数，正值表示焦距变远，负值表示焦距拉近。
取值：-100~100, 且不能为0

3、响应参数

参数

是否必选

参数类型

描述

RequestId

否

String

该条接口请求ID

Code是String错误码 0:表示成功
Message否String提示信息
Data否object返回数据
├─DeviceId否String设备ID

4、示例

GET https://api.unicloud.com/univms?Action=StartCloudDevicePtz&DeviceID=gb763487hfdk8a&Pan=5&Tilt =5&Mode=0&公共请求参数

返回示例:

{
    "RequestId": "b9de1a62-d09e-4d34-9a61-38f0f56564b6",
    "Code": "0",
    "Data": {
        "DeviceId": "gb763487hfdk8a_startime_endtime"
    }
}