CreateLiveStreamMonitor
创建监播室
服务地址:
华东2(上海)
输入参数
只看必填
MonitorName监播名称
OutputTemplate监播输出模版
Domain监播域名
App监播输出流的App
Stream监播输出流名
InputList监控流输入列表
MonitorConfig监播告警阈值设置
CallbackUrl支持输入HTTP(S)格式的回调地址
DingTalkWebHookUrl监播钉钉告警通过钉群机器人进行告警信息的通知
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

调用本接口创建监播室,调用时请保证参数设置符合要求。

QPS 限制

本接口的单用户 QPS 限制为 10 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。

请求参数

字段名称字段详情
MonitorNamestring

监播名称。

示例值:liveMonitor****参考取值来源:
    DescribeLiveStreamMonitorList
OutputTemplatestring

监播输出模版。类型取值:展开详情

示例值:lp_ud
Domainstring

监播域名。

示例值:demo.aliyundoc.com参考取值来源:
    AddLiveDomain
    DescribeLiveUserDomains
Appstring

监播输出流的 App。展开详情

示例值:monitor****
Streamstring

监播输出流名,不传则系统随机生成。

示例值:monitorStream****参考取值来源:
    UpdateMixStream
    CreateMixStream
    AddLiveStreamMerge
    DescribeMixStreamList
InputListstring

监控流输入列表。具体内容,请参考下表 InputConfig

示例值:InputConfig
MonitorConfigstring

监播告警阈值设置,JSON 格式,具体内容,请参考下表 MonitorConfig。

示例值:"{\"fpsLowThres\": 0.6,\"brLowThres\": 1.1,\"eofDurationThresSec\": 10}"
CallbackUrlstring

支持输入 HTTP(S)格式的回调地址。

示例值:http://guide.aliyundoc.com/notify参考取值来源:
    ModifyLiveMessageAppCallback
DingTalkWebHookUrlstring

监播钉钉告警通过钉群机器人进行告警信息的通知,请先设置钉群机器人,并在此输入机器人的 HTTP(S)地址。详情请参见自定义机器人接入展开详情

示例值:https://oapi.dingtalk.com/robot/send?access_token=7a7d404056eee1f2fd944ace9bcfc361dc6448583e1d3d3baa****

请求说明

InputConfig

名称类型描述示例值
IndexInteger索引,前端使用。1
LayoutIdInteger布局 ID,必须从 1 开始。1
StreamNameString监播流的显示名称。monitorStream****
InputUrlString输入流地址。demo.aliyundoc.com
LayoutConfigLayoutConfig布局信息。参考下表 LayoutConfig
PlayConfigPlayConfig播放配置。参考下表 PlayConfig

LayoutConfig

名称类型描述示例值
FillModeString填充类型,前端填 none 即可。none
PositionReferString设置元素的 position 参考坐标值,取值:topLeft(左上),topRight(右上),bottomLeft(左下),bottomRight(右下)。topLeft
PositionNormalizedFloat表示该 Layer 元素填充区位置归一化值[x,y]。
x 和 y 的取值范围为 0~1。
例如[0.1,0.1] 代表左上角水平偏移 10%, 垂直偏移 10%。
[0.1, 0.1]
SizeNormalizedFloat表示该 Layer 元素需要填充的尺寸大小[w,h]。
w 和 h 取值范围为 0~1,宽高都是进行了归一化计算。
例如 [0.2,0.3]代表水平占比 20%,垂直占比 30%。
[0.2, 0.3]

PlayConfig

名称类型描述示例值
VolumeRateFloat音量。取值 0~1 之间,精确小数点后 2 位。0.50

MonitorConfig

名称类型描述示例值
fpsLowThresFloat视频帧率告警阈值。此阈值为比例系数,取值范围(0.0,1.0],默认值 0.7。当监播流的视频帧率<帧率告警阈值*直播流原始帧率,则会报警。0.7
brHighThresFloat音视频码率告警阈值。此阈值为比例系数,取值范围(0.0,100],默认值 1.0。当监播流的音视频码率>码率告警阈值*直播流原始码率,则会报警。1.0
eofDurationThresSecFloat断流时长检测阈值,表示当前监播流断流超过多少时间(单位:秒)才会报警。取值范围(0,65535],默认值 0。- 由于断流后连接不断,系统会有内部收包超时时间(5 秒)来判断断流。因此如果设置此参数时间<=5s,实际检测时间仍为 5s;如果设置该项时间>5s,实际检测时间为设置值,只是前 5s 为内部收包超时,剩余时间为持续等待流没有恢复时间。 - 如果断流后没达到此超时时间流自动恢复,则不会报警。如果断流未超时,此时修改了监播地址,对前流也不会继续检测超时和报警。10

返回参数

字段名称字段详情
MonitorIdstring

监播室 ID。

示例值:445409ec-7eaa-461d-8f29-4bec2eb9****
RequestIdstring

请求 ID。

示例值:5c6a2a0d-f228-4a64-af62-20e91b96****
变更历史
变更时间变更内容概要操作
2024-09-04
变更请求参数InputList