云台控制

POST

/channels/{id}/ptz/control

按通道所属协议分发：GB28181 走 SIP MESSAGE（控制码遵循 GB/T 28181-2022 附录 A.3），ONVIF 走 ONVIF PTZ 服务；
RTSP/RTMP 等纯流通道不支持。通道详情的 ptz 字段仅用于展示，服务端不根据该字段拦截控制请求。

注意：

continuous 为连续移动，必须由客户端在松手时下发 stop；服务端另有 30 秒兜底，超时未收到新指令会自动停止；

通道离线、协议不支持云台或参数非法时返回 400/500 并带 msg。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Path 参数

Body 参数application/json必填

示例

{
    "action": "continuous",
    "direction": "up",
    "speed": 0,
    "x": -1,
    "y": -1,
    "zoom": 0,
    "preset_id": "string",
    "preset_op": "goto"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/channels//ptz/control' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "action": "continuous",
    "direction": "up",
    "speed": 0,
    "x": -1,
    "y": -1,
    "zoom": 0,
    "preset_id": "string",
    "preset_op": "goto"
}'

返回响应

🟢200

application/json

成功

Bodyapplication/json

示例

{
    "msg": "string"
}

🟠400BadRequest

修改于 2026-10-25 13:17:40

解绑通道录像计划

获取流媒体信息