开始镜头转动
最近更新时间：2025-02-21 02:50:54
1. 接口描述
接口请求域名: vssapi.ctyun.cn
默认接口请求频率限制：500 次/秒。
开始镜头转动，如水平、垂直、缩放（变焦）等。
2. 请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | StartDeviceMove | 操作接口名，系统规定参数。 |
| DeviceId | String | 是 | 29942028422873997 | 设备 ID。 |
| Pan | Long | 否 | 255 | 水平转动速度参数，正值表示向右水平转动。 取值: -255~255 |
| Tilt | Long | 否 | 255 | 垂直转动速度参数，正值表示向上垂直转动。 取值: -255~255 |
| Zoom | Long | 否 | 15 | 缩放（变焦）速度参数，正值表示放大。 在 Pan、Tilt 字段都为 0 值时，取值: -15~15 |
| InProtocol | String | 是 | ehome | 可取值：gb28181, ehome。如果是 gb28181，可不填 |
3. 返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| DeviceId | String | 设备 ID。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
4.1 请求示例
https://vssapi.ctyun.cn/
?Action=StartDeviceMove
&DeviceId=29942028422873997
&Pan=255
&Tilt=255
&Zoom=15
&Version=2020-06-12
&AccessKeyId= O0G0BPBI2T9YUD3U****
&Signature=cMKjvNwq%2FXGhGK6a%2FcwZwzue7c4%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=1016288166
&SignatureVersion=1.0
&Timestamp=1598952660
4.2 返回示例
{
"DeviceId": "208383238668288",
"RequestId": "xaStNsngy6AWNGunPSDUUZ"
}
5. 错误码
| ErrorCode | ErrorMessage |
|---|---|
本页目录：