更新监播室配置。
接口说明
此接口针对监播室配置进行更新,监播室在启动状态下对输入源配置更新可实时生效。
QPS 限制
本接口的单用户 QPS 限制为 10 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
live:UpdateLiveStreamMonitor |
update |
*全部资源
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
RegionId |
string |
否 |
||
MonitorId |
string |
是 |
监播室 ID。 说明
通过查看 CreateLiveStreamMonitor 接口的返回参数获取 MonitorId 值。 |
445409ec-7eaa-461d-8f29-4bec2eb9**** |
MonitorName |
string |
否 |
监播室名称。 |
liveMonitor**** |
Domain |
string |
否 |
监播输出域名。 |
demo.aliyundoc.com |
App |
string |
否 |
监播输出流的 App。 名称可自取,不传默认用 monitor 作为 AppName 名称。 |
monitor**** |
Stream |
string |
否 |
监播输出流名。 |
monitorStream**** |
OutputTemplate |
string |
否 |
监播输出模版。类型取值:
|
lp_ud |
InputList |
string |
是 |
监控流输入列表。具体内容,请参考下表 InputConfig。 |
InputConfig |
MonitorConfig |
string |
否 |
监播告警阈值设置,JSON 格式,具体内容,请参考下表 MonitorConfig。 |
"{\"fpsLowThres\": 0.6,\"brLowThres\": 1.1,\"eofDurationThresSec\": 10}" |
CallbackUrl |
string |
否 |
支持输入 HTTP(S)格式的回调地址。 |
http://guide.aliyundoc.com/notify |
DingTalkWebHookUrl |
string |
否 |
监播钉钉告警通过钉群机器人进行告警信息的通知,请先设置钉群机器人,并在此输入机器人的 HTTP(S)地址。详情请参见自定义机器人接入。 说明
配置钉群机器人自定义关键词为“告警”,否则消息无法接收。 |
https://oapi.dingtalk.com/robot/send?access_token=7a7d404056eee1f2fd944ace9bcfc361dc6448583e1d3d3baa**** |
InputConfig
名称 | 类型 | 描述 | 示例值 |
Index | Integer | 索引,前端使用。 | 1 |
LayoutId | Integer | 布局 ID,必须从 1 开始。 | 1 |
StreamName | String | 监播流的显示名称。 | monitorStream**** |
InputUrl | String | 输入流地址。 | demo.aliyundoc.com |
LayoutConfig | LayoutConfig | 布局信息。 | 参考下表 LayoutConfig |
PlayConfig | PlayConfig | 播放配置。 | 参考下表 PlayConfig |
LayoutConfig
名称 | 类型 | 描述 | 示例值 |
FillMode | String | 填充类型,前端填 none 即可。 | none |
PositionRefer | String | 设置元素的 position 参考坐标值,取值:TopLeft(左上),TopRight(右上),BottomLeft(左下),BottomRight(右下)。 | TopLeft |
PositionNormalized | Float | 表示该 Layer 元素填充区位置归一化值[x,y]。 | [0.1, 0.1] |
SizeNormalized | Float | 表示该 Layer 元素需要填充的尺寸大小[w,h]。 | [0.2, 0.3] |
PlayConfig
名称 | 类型 | 描述 | 示例值 |
VolumeRate | Float | 音量。取值 0~1 之间,精确小数点后 2 位。 | 0.50 |
MonitorConfig
名称 | 类型 | 描述 | 示例值 |
fpsLowThres | Float | 视频帧率告警阈值。此阈值为比例系数,取值范围(0.0,1.0],默认值 0.7。当监播流的视频帧率<帧率告警阈值*直播流原始帧率,则会报警。 | 0.7 |
brHighThres | Float | 音视频码率告警阈值。此阈值为比例系数,取值范围(0.0,100],默认值 1.0。当监播流的音视频码率>码率告警阈值*直播流原始码率,则会报警。 | 1.0 |
eofDurationThresSec | Float | 断流时长检测阈值,表示当前监播流断流超过多少时间(单位:秒)才会报警。取值范围(0,65535],默认值 0。 - 由于断流后连接不断,系统会有内部收包超时时间(5 秒)来判断断流。因此如果设置此参数时间<=5s,实际检测时间仍为 5s;如果设置该项时间>5s,实际检测时间为设置值,只是前 5s 为内部收包超时,剩余时间为持续等待流没有恢复时间。 - 如果断流后没达到此超时时间流自动恢复,则不会报警。如果断流未超时,此时修改了监播地址,对前流也不会继续检测超时和报警。 | 10 |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
|||
RequestId |
string |
请求 ID。 |
5c6a2a0d-f228-4a64-af62-20e91b9676b3 |
示例
正常返回示例
JSON
格式
{
"RequestId": "5c6a2a0d-f228-4a64-af62-20e91b9676b3"
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | InvalidUserId.Malformed | %s | |
400 | InvalidParameter.Malformed | %s | |
400 | MissingParameter | %s | |
400 | InvalidMonitorId.Malformed | %s | |
401 | IllegalOperation | %s | |
500 | InternalError | %s | |
404 | InvalidDomainName.NotFound | %s | |
404 | StreamMonitorNotExist | %s |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。