跳到主要内容
版本:4.0.0

远程录像回放控制

POST /strm/replay/ctrl

本接口对请求ID(reqId)对应的远程录像音视频流进行控制。

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

请求

POST https://n11.gratour.info:7011/v1/strm/replay/ctrl
Content-Type: application/json
X-Auth-Token: HrWwReOAQ9WdLnJQ1JYivA

{
"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错误信息