跳到主要内容
版本:3.4.2

打开远程录像回放

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
}

请求实体属性

属性数据类型必要说明
simNostringY终端识别号
channelintY音视频逻辑通道号。参见JT/T 1078标准定义的车载视频逻辑通道号定义表
mediaTypeint媒体类型:
  • 0: 音视频
  • 1: 音频
  • 2: 视频
  • 3: 音频或视频
未指定时,默认为:0
codeStreamint码流类型:
  • 0: 所有码流
  • 1: 主码流
  • 2: 子码流
如果只请求音频,此属性为0。未指定时,默认为:0
storageTypeint存储类型:
  • 0: 所有存储器
  • 1: 主存储器
  • 2: 灾备存储器
未指定时,默认为:0
modeint回放方式:
  • 0: 正常回放
  • 1: 快进回放
  • 2: 关键帧快退回放
  • 3: 关键帧播放
  • 4: 单帧上传
未指定时,默认为:0
factorint快进或快退倍数:
  • 0: 无效
  • 1: 1倍
  • 2: 2倍
  • 3: 4倍
  • 4: 8倍
  • 5: 16倍
回放方式(mode)为12时,此属性有效,否则为0。未指定时默认为0
startTimestringY开始时间。格式:yyyy-MM-dd HH:mm:ss。回放方式(mode)为4时,该字段表示单帧上传时间
endTimestring结束时间。格式:yyyy-MM-dd HH:mm:ss。此属性不指定时表示一直回放(0000-00-00 00:00:00)。回放方式(mode)为4时,该属性无效1
protoint请求的客户端协议类型:
  • 0: HTTP FLV
  • 1: HLS
未指定时默认为0
connIdxint连接序号,0-17。用于后台分配不同的服务器给客户端。未指定时默认为0
asyncboolean是否采用异步打开模式。未指定时默认为false
saveOnServerboolean播放时是否同时存储在服务端的本地媒体存储目录。未指定时视为:false
detectMediaTypboolean部分终端存在无音频的情况,即使下发请求音视频请求,终端实际推送的也只有视频而无音频,此时可使用媒体服务的码流媒体类型检测功能,由媒体服务根据码流确定实际媒体类型(结果由OpenStrmResultmediaTyp属性返回)。本属性用于指示是否强制服务端对终端实际码流进行媒体类型(mediaTyp)检测。如指定了true值,则服务端将进行媒体类型检测,并将检测到的媒体类型返回到OpenStrmResult结构的mediaTyp属性。如指定了false值,则直接根据dataTyp的值进行判断,而不进行媒体类型检测。不指定时,值视为false
audioCfgAudioConfig指定返回的媒体流的音频格式。不指定时使用服务端配置的默认音频设置
rtspSrcRtspSource采用RTSP源进行播放。打开JT/T 1078协议终端时,不需要指定本属性。
1:部分终端存在指定结束时间为0时,指令不执行也不应答的情况。

AudioConfig

属性数据类型必要说明
sampleRateintY采样率。为下列值之一:
  • 8000
  • 11025
  • 22050
  • 44100
  • 48000
  • 64000
  • 96000
指定高于音频源的采样率不能提高音质
channelsintY声道数。为下列值之一:
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 8
指定高于音频源的声道数不能提高音质

RtspSource

属性数据类型必要说明
urlstringY所要拉取的RTSP流源地址。如:rtsp://n11.gratour.info/test/strm1,此地址必须要能被媒体服务所能访问到。当媒体源要求鉴权时,可以在url中带用户名和密码(不推荐),如: rtsp://user:passwd@n11.gratour.info/test/strm1 ,此时,本结构的 userpwd属性被忽略
userstring当媒体源要求鉴权时,本属性指定用户名。当url属性中包含用户名时,本属性被忽略
pwdstring当媒体源要求鉴权时,本属性指定用户密码。当url属性中包含用户密码时,本属性被忽略

应答

{
"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."
}

应答实体属性

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

OpenReplayStrmResult

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