远程录像回放控制

POST /strm/replay_ctrl

本接口对请求ID(reqId)对应的远程录像音视频流进行控制（预处理）。注意，本接口只是先在媒体服务端进行预处理，如检查当前请求是否有权限对流进行控制， 当前是否有其它正在进行的播放。当本接口返回成功后，企业系统再实际向终端下发相应的指令。

• 如果控制命令(ctrl)为结束回放(2)，则接口调用返回后，对应的reqId将不可再使用。

请求

POST https://n11.gratour.info:7011/strm/replay_ctrl
Content-Type: application/json
Authorization: Basic YWRtaW46YWRtaW4

{
  "reqId": "AbctuB9sSJe8bbBzv-yr9g",
  "ctrl": 3,
  "factor": 3
}

请求实体属性

属性	数据类型	必要	说明
reqId	string	Y	远程录像回放请求ID
ctrl	int	Y	控制命令： 0: 开始回放。成功执行该命令后，服务端向客户端推送act为resumed的流媒体状态通知 1: 暂停回放。成功执行该命令后，服务端向客户端推送act为paused的流媒体状态通知 2: 结束回放。成功执行该命令后，服务端向客户端推送act为closed的流媒体状态通知 3: 快进回放 4: 关键帧快退回放 5: 拖动回放 6: 关键帧播放
factor	int		快进或快退倍数： 1: 1倍 2: 2倍 3: 4倍 4: 8倍 5: 16倍 当ctrl == 3或ctrl == 4时，此属性有效
time	long		拖动回放的时间点，注意，此属性为Epoch millis-seconds, 数据类型为长整型。, 仅当ctrl==5时有效

应答

{
  "errCode": 0,
  "message": "OK."
}

应答实体属性

属性	数据类型	必要	说明
errCode	int	Y	错误码。 如果当前有其它共享用户正使用流，返回错误码：-25 如果reqId无效，返回错误码：-8 如果错误使用实时音视频的reqId调用本接口，将返回错误码：-6
message	string	Y	错误信息