找不到 API ? 点击 反馈吧
- 域名管理
- 直播预热
- 直播拉流
- 直播流管理
- 边缘转推
- 中心转推
- 主备合流
- 直播延播
- 推流回调
- 直播安全
- 直播时移
- 直播转码
- 直播录制存储至VOD
- 直播录制存储至OSS
- 直播截图
- 直播封装
- 直播审核
- 全球加速
- 直播延迟
- 监控统计
- 用量查询
- 云导播
- 云端合流
- 直播水印
- 边缘转码
- 直播日志
- 直播监播
- 互动消息服务端接口
- 互动消息(新)
- 实时音视频
- 高级功能
- 拉流转推
- 双流灾备
- 边缘脚本
- 工具箱
- 其他
CreateLiveStreamMonitor
创建监播室
服务地址:
华东2(上海)
参数配置
高级配置
输入参数
只看必填
注意事项
MonitorName监播名称
OutputTemplate监播输出模版
Domain监播域名
App监播输出流的App
Stream监播输出流名
InputList监控流输入列表
MonitorConfig监播告警阈值设置
CallbackUrl支持输入HTTP(S)格式的回调地址
DingTalkWebHookUrl监播钉钉告警通过钉群机器人进行告警信息的通知
文档
调用结果
SDK 示例
CLI示例
相关示例
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
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 |
请求说明
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]。 x 和 y 的取值范围为 0~1。 例如[0.1,0.1] 代表左上角水平偏移 10%, 垂直偏移 10%。 | [0.1, 0.1] |
SizeNormalized | Float | 表示该 Layer 元素需要填充的尺寸大小[w,h]。 w 和 h 取值范围为 0~1,宽高都是进行了归一化计算。 例如 [0.2,0.3]代表水平占比 20%,垂直占比 30%。 | [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 |
返回参数
字段名称 | 字段详情 |
---|---|
MonitorIdstring | 监播室 ID。 示例值:445409ec-7eaa-461d-8f29-4bec2eb9**** |
RequestIdstring | 请求 ID。 示例值:5c6a2a0d-f228-4a64-af62-20e91b96**** |
变更历史
变更时间 | 变更内容概要 | 操作 | |
---|---|---|---|
2024-09-04 | 变更请求参数InputList |