打开远程录像回放
replayOpen
function replayOpen(params: GnssOpenReplayParams): Promise<ApiReply<GnssOpenStrmResult>> {
}
本方法用于指示终端向媒体服务推送指定的录像文件的媒体流,并返回服务端分配的媒体地址。
- 本方法调用之前需要调用查询终端远程录像方法 qryTermSideStoredAv ,以获得录像文件的相关信息。
- 远程录像回放不支持多会话同时播放。
- 要关闭实时音视频流,可调用 releaseStrmReq 方法
参数
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
params | GnssOpenReplayParams | Y | 打开远程录像回放请求参数 |
GnssOpenReplayParams
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
simNo | string | Y | 终端识别号 |
channel | int | Y | 音视频逻辑通道号。参见JT/T 1078标准定义的车载视频逻辑通道号定义表 |
mediaType | int | 媒体类型:
0 | |
codeStream | int | 码流类型:
0 。未指定时,默认为:0 | |
storageType | int | 存储类型:
0 | |
mode | int | 回放方式:
0 | |
factor | int | 快进或快退倍数:
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 | |
subProto | string | 子协议类型:
| |
connIdx | int | 连接序号,0-17。用于后台分配不同的服务器给客户端。未指定时默认为0 | |
async | boolean | 是否采用异步打开模式。未指定时默认为false | |
saveOnServer | boolean | 播放时是否同时存储在服务端的本地媒体存储目录。未指定时视为:false | |
trace | int | 跟踪模式:
0 | |
detectMediaTyp | boolean | 部分终端存在无音频的情况,即使下发请求音视频请求,终端实际推送的也只有视频而无音频,此时可使用媒体服务的码流媒体类型检测功能,由媒体服务根据码流确定实际媒体类型(结果由OpenStrmResult 的mediaTyp 属性返回)。本属性用于指示是否强制服务端对终端实际码流进行媒体类型(mediaTyp )检测。如指定了true 值,则服务端将进行媒体类型检测,并将检测到的媒体类型返回到OpenStrmResult结构的mediaTyp 属性。如指定了false 值,则直接根据dataTyp 的值进行判断,而不进行媒体类型检测。不指定时,值视为false 。 | |
audioCfg | AudioConfig | 指定返回的媒体流的音频格式。不指定时使用服务端配置的默认音频设置 | |
rtspSrc | RtspSource | 采用RTSP源进行播放。打开JT/T 1078协议终端时,不需要指定本属性。 |
AudioConfig
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
sampleRate | int | Y | 采样率。为下列值之一:
|
channels | int | Y | 声道数。为下列值之一:
|
RtspSource
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
url | string | Y | 所要拉取的RTSP流源地址。如:rtsp://n11.gratour.info/test/strm1 ,此地址必须要能被媒体服务所能访问到。当媒体源要求鉴权时,可以在url中带用户名和密码(不推荐),如: rtsp://user:passwd@n11.gratour.info/test/strm1 ,此时,本结构的 user 和pwd 属性被忽略 |
user | string | 当媒体源要求鉴权时,本属性指定用户名。当url 属性中包含用户名时,本属性被忽略 | |
pwd | string | 当媒体源要求鉴权时,本属性指定用户密码。当url 属性中包含用户密码时,本属性被忽略 |
返回值
Promise<ApiReply<GnssOpenStrmResult>>
GnssOpenStrmResult 打开媒体流结果
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
reqId | string | Y | 由平台分配的请求ID,用于监测流通知,或播放控制 |
instanceId | string | Y | 平台分配的流媒体实例ID |
channel | int | Y | 音视频逻辑通道号。参见JT/T 1078标准定义的车载视频逻辑通道号定义表 |
proto | int | Y | 请求的客户端协议类型:
|
playUrl | string | Y | 播放地址 |
ready | boolean | Y | 流是否已经可以播放。为false 时,要等到收到act为ready 的流媒体通知才能播放。 |
wsUrl | string | WebSocket地址,用于对讲时客户端提交音频数据。此地址使用stomp协议。仅当请求的流类型为实时流,且数据类型(dataTyp )为2: 对讲 时有效。 | |
taUrl | string | WebSocket地址,用于对讲时客户端提交音频数据。此地址使用二进制websocket协议。仅当请求的流类型为实时流,且数据类型(dataTyp )为2: 对讲 时有效。 | |
mediaTyp | string | Y | 流的媒体类型:
|