打开远程录像回放

POST /strm/replay/open

本接口用于指示终端向媒体服务推送指定的录像文件的媒体流，并返回服务端分配的媒体地址。本接口调用之前需要调用查询终端远程录像接口GET /strm/stored， 以获得目标录像文件的相关信息。远程录像回放不支持多会话同时播放。

请求

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

{
  "simNo": "13320200317",
  "channel": 1,
  "mediaType": 0,
  "codeStream": 1,
  "storageType": 1,
  "mode": 0,
  "factor": 0,
  "startTime": "2020-03-01 11:08:47",
  "endTime": "2020-03-01 11:16:18",
  "proto": 0,
  "async": true
}

请求实体属性

属性	数据类型	必要	说明
simNo	string	Y	终端识别号
channel	int	Y	音视频逻辑通道号。参见JT/T 1078标准定义的车载视频逻辑通道号定义表
mediaType	int		媒体类型： 0: 音视频 1: 音频 2: 视频 3: 音频或视频 未指定时，默认为：0
codeStream	int		码流类型: 0: 所有码流 1: 主码流 2: 子码流 如果只请求音频，此属性为0。未指定时，默认为：0
storageType	int		存储类型： 0: 所有存储器 1: 主存储器 2: 灾备存储器 未指定时，默认为：0
mode	int		回放方式： 0: 正常回放 1: 快进回放 2: 关键帧快退回放 3: 关键帧播放 4: 单帧上传 未指定时，默认为：0
factor	int		快进或快退倍数： 0: 无效 1: 1倍 2: 2倍 3: 4倍 4: 8倍 5: 16倍 回放方式(mode)为1和2时，此属性有效，否则为0。未指定时默认为0
startTime	string	Y	开始时间。格式：yyyy-MM-dd HH:mm:ss。回放方式(mode)为4时，该字段表示单帧上传时间
endTime	string		结束时间。格式：yyyy-MM-dd HH:mm:ss。此属性不指定时表示一直回放（0000-00-00 00:00:00)。回放方式(mode)为4时，该属性无效1
proto	int		请求的客户端协议类型： 0: HTTP FLV 1: HLS 未指定时默认为0
connIdx	int		连接序号，0-17。用于后台分配不同的服务器给客户端。未指定时默认为0
async	boolean		是否采用异步打开模式。未指定时默认为false

注¹：部分终端存在指定结束时间为0时，指令不执行也不应答的情况。

应答

{
"data": [
    {
      "reqId": "AbctuB9sSJe8bbBzv-yr9g",
      "ctrl": true,
      "ready": false,
      "playUrl": "http://t2.gratour.info:20022/s/13305071289_1_0?a\u003dS7rAwnY0\u0026b\u003dS91-lPEJg_yulbO6okcRQrguBqEFlUH-YmSXQewOJYSpWg8_7Jx2xZdBYiNZhWZETYFmZ3Kd8j_qguPRf10Yfvl_WB8H5tFUHkh6nILIiZU6wKN3buuvaXAKNA93QmIsk77baWYzkuY70l9TQswdvRRNOBXz9fszrWeQ5aeca6B9PXXUw_WVZiQBiUfrgF7CS2N\u0026reqId\u003dM2MyM2FmMTA3NDQyNGE1YzhlY2VkMzc3ZWU3ZDEwYTQ",
      "mediaTyp": "av"
    }
  ],
  "errCode": 0,
  "message": "OK."
}

应答实体属性

属性	数据类型	必要	说明
errCode	int	Y	错误码。 如果请求流时恰好遇到流正在关闭，返回错误码-207：操作失败，请重试 如果设备不在线，返回错误码：-27 如果有其它会话当前正在以排他方式或以不兼容的方式使用所请求的通道，返回错误：-21 如果长时间未能打开流，返回错误码：-5 服务端发生异常时，返回错误码：-2 其它错误，如设备连上随即断开连接，返回错误码：-3
message	string	Y	错误信息。
data	array[OpenReplayStrmResult]		返回的结果对象数组。元素为OpenReplayStrmResult类型，见下
count	int		返回的记录数。

OpenReplayStrmResult

属性	数据类型	必要	说明
reqId	string	Y	由平台分配的请求ID，用于监测流通知，或播放控制
instanceId	string	Y	平台分配的流媒体实例ID
ctrl	boolean	Y	当前请求是否获得音视频的控制权。除非有更高级的用户抢占，否则第一个打开通道的客户端将获得控制权，后续打开该通道的客户端只能获得共享播放权。当获得控制权的客户端关闭流以后，在该客户端之后第一个请求的客户端继承控制权。
playUrl	string	Y	播放地址。
ready	boolean	Y	流是否已经可以播放。
mediaTyp	string	Y	媒体类型： av: 音频和视频 a: 仅音频 v: 仅视频