打开实时音视频
liveOpen
function liveOpen(params: GnssOpenLiveParams): Promise<ApiReply<GnssOpenStrmResult>> {
}
本方法用于指示终端向媒体服务实时推送指定通道的媒体流，并返回服务端分配的媒体地址。
- 同一通道的实时音视频支持多个会话同时播放。
- 要关闭实时音视频流，可调用 releaseStrmReq 方法
参数
| 参数名 | 数据类型 | 必要 | 说明 |
|---|---|---|---|
| params | GnssOpenLiveParams | Y | 打开实时音视频参数 |
GnssOpenLiveParams 打开实时音视频参数
| 属性名 | 数据类型 | 必要 | 说明 |
|---|---|---|---|
| simNo | string | Y | 终端识别号 |
| channel | int | Y | 通道号。参见JT/T 1078标准定义的车载视频逻辑通道号定义表。对讲时，可以不指定通道号。其他情况，通道号为必填。 |
| dataType | int | 数据类型：
0 | |
| codeStream | int | 码流类型：
0 | |
| proto | int | 请求的客户端协议类型：
0 | |
| subProto | string | 子协议类型：
| |
| connIdx | int | 连接序号。用于后台分配不同的服务器给客户端。仅在同步模式时有意义。未指定时视为：0 | |
| async | boolean | 是否采用异步打开模式。未指定时视为：false | |
| saveOnServer | boolean | 播放时是否同时存储在服务端的本地媒体存储目录。未指定时视为：false | |
| trace | int | 跟踪模式：
0 | |
| 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 | 流的媒体类型：
|