实时音视频控制
POST /strm/live_ctrl
本接口对请求ID(reqId
)对应的实时音视频流进行控制(预处理)。注意,本接口只是先在媒体服务端进行预处理,如检查当前请求是否有权限对流进行控制,
当前是否有其它正在进行的播放。当本接口返回成功后,企业系统再实际向终端下发相应的指令。
- 如果控制命令(
ctrl
)为关闭音视频传输(0
),则接口调用返回后,对应的reqId
将不可再使用。 - 关闭音视频传输时,如果当前有其它用户正在使用通道,将返回错误码
-25
,调用者可以忽略此错误码。
请求
POST https://n11.gratour.info:7011/strm/live_ctrl
Content-Type: application/json
Authorization: Basic YWRtaW46YWRtaW4
{
"reqId": "AbctuB9sSJe8bbBzv-yr9g",
"ctrl": 0,
"closeAction": 0
}
请求实体属性
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
reqId | string | Y | 实时音视频请求ID |
ctrl | int | Y | 控制命令:
|
closeAction | int | 关闭动作:
ctrl ==0 时有效 | |
codeStream | int | 新的码流类型:
ctrl ==1 时有效 |
应答
{
"errCode": 0,
"message": "OK."
}
应答实体属性
属性 | 数据类型 | 必要 | 说明 |
---|---|---|---|
errCode | int | Y | 错误码:
|
message | string | Y | 错误信息 |