文档中心

智能视联

设备控制

DeviceRecordControl - 设备端录像控制

向GB28181设备下发录像控制指令，控制设备端本地手动录像的开启/停止。只下发标准信令，不维护设备录像状态；设备是否真正执行由设备侧保证。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Action string 必选示例值：DeviceRecordControl

要执行的操作，取值：DeviceRecordControl。

Version string 必选示例值：2023-10-01

API的版本，取值：2023-10-01。

Body

StreamID string 可选示例值：stream-xxxxxxxx

流 ID（与 DeviceNSID+ChannelID 二选一；同时传时以 StreamID 为准）

DeviceNSID string 可选示例值：34020000001320000001

设备国标 ID（未传 StreamID 时必填，需同时传 ChannelID）

ChannelID string 可选示例值：34020000001320000002

通道国标 ID（未传 StreamID 时必填，需同时传 DeviceNSID）

Command string 必选示例值：Record

录像命令：Record=开始手动录像；StopRecord=停止手动录像

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	InvalidParameter.ControlArgs	Invalid control args	参数解析/校验失败；Command 非法；流不是 GB28181；流缺少 SIPID/DeviceNSID/ChannelID
400	InvalidParameter.StreamNotFound	Stream not found	流不存在或不属于当前账号
500	InternalError.StreamDB	Stream db error	查询流信息失败
500	InternalError.DeviceOffline	Device is offline	设备不在线，未下发信令
500	InternalError.SipError	Device SIP error	设备信令发送失败（含设备无响应超时）
500	InternalError.SipTimeout	Device SIP timeout	设备信令超时

最近更新时间：2026.11.03 11:22:41

这个页面对您有帮助吗？

有用

无用