跳到主要内容
版本:3.4.0

远程录像回放控制

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
}

请求实体属性

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

应答

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

应答实体属性

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