实时音视频控制

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	控制命令： 0: 关闭音视频传输。成功执行该命令后，服务端向相关客户端推送act为closed的流媒体状态通知 1: 切换码流。成功执行该命令后，服务端向相关客户端推送act为changeCodeStrm的流媒体状态通知 2: 暂停流。成功执行该命令后，服务端向相关客户端推送act为paused的流媒体状态通知 3: 恢复流。成功执行该命令后，服务端向相关客户端推送act为resumed的流媒体状态通知 4: 关闭双向对讲。成功执行该命令后，服务端向相关客户端推送act为closed的流媒体状态通知
closeAction	int		关闭动作： 0: 关闭音视频 1: 仅关闭音频（暂不支持） 2: 仅关闭视频（暂不支持） 仅当ctrl==0时有效
codeStream	int		新的码流类型: 0: 主码流 1: 子码流 仅当ctrl==1时有效

应答

{
  "errCode": 0,
  "message": "OK."
}

应答实体属性

属性	数据类型	必要	说明
errCode	int	Y	错误码： 如果当前有其它共享用户正使用流，返回错误码：-25，调用者可以忽略此错误码 如果reqId无效，返回错误码：-8 如果错误使用远程录像回放的reqId调用本接口，将返回错误码：-6
message	string	Y	错误信息