阿里云视频直播为您提供云端合流服务,本文介绍云端合流的功能特性和使用方法。

您可以调用开放接口,通过直播中心的合流服务器拉取多个视频源,依靠云端强大的处理能力将多路视频源按照您设置的布局进行合流,合成一路直播流后,通过边缘加速分发给观众观看。

说明
  • 云端合流目前处于公测阶段。无需开通即可使用,且暂不收费。
  • 每个UID下并发合流任务上限为10路,如需扩充请提交工单。关于如何提交工单,请参见联系我们
  • 云端合流目前仅支持华北2和华东2地区。

功能特性

功能描述特性
多路合流将多路视频源推至直播中心,合流为一路直播流。
  • 支持添加RTMP、FLV和ARTC协议的直播流。
    说明 超低延时直播使用协议为ARTC。
  • 支持添加文件流。
  • 最多添加8个视频源。
预设布局提供预设的合成直播流画面布局,满足不同场景下的直播。提供7种预设布局,布局请参见合流预设布局参考
自定布局根据需要,添加自定义合成后直播流的布局。支持设置窗格个数、尺寸和位置。
合流输出将合流的多路视频源以直播流的形式输出。支持自定义合流输出域名,可用该域名观看合流后的内容。
合流查询查询当前合流任务列表及相应配置信息。支持实时查询。
合流更新在合流观看过程中更新视频源、合流布局,且无缝切换。不支持更新输出分辨率等内容。
自动删除自动删除合流任务。支持在创建合流任务时设定自动删除时间,到期合流任务自动删除以节省流量,默认为7天。
重要 在合流创建成功后不可再修改。
合流回调合流任务状态回调。支持在创建合流时向您的回调地址发送创建成功或创建失败的消息,以便让您及时获取合流任务创建的结果。

使用方法

视频直播支持通过调用API接口的方式,使用云端合流服务,包括创建合流、更新合流、查询合流和删除合流。调用次序如下:

API调用顺序

具体调用方法和参数请参见如下API文档:

场景描述接口代码示例
创建合流(预设布局)使用预设布局模板创建合流。
以MixStreamLayout-2-1模板为例,最终效果为:压缩2-1
CreateMixStream
  • 传入输入源配置(个数、类型、地址、叠加顺序、尺寸、位置、填充方式)。
  • 传入合流播放地址(域名、Appname、Streamname)。
  • 传入合流输出分辨率。
以MixStreamLayout-2-1模板为例,代码示例请参见合流代码示例
创建合流(自定布局)使用自定义布局创建合流。
以两路输入流为例,最终效果为:自定义布局
CreateMixStream
  • 传入输入源配置(个数、类型、地址、叠加顺序、尺寸、位置、填充方式)。
  • 传入合流播放地址(域名、Appname、Streamname)。
  • 传入合流输出分辨率。
以两路输入流为例,代码示例请参见合流代码示例
更新合流更新合流的视频源或布局。UpdateMixStream

传入输入源配置(个数、类型、地址、叠加顺序、尺寸、位置、填充方式)。

说明 UpdateMixStream的参数为全量参数,调用时需要传入更新后的全量配置。

例如:原合流为A、B、C、D共四路视频源合流,目标为删除其中C、D两路视频源,那么需要调用UpdateMixStream传入A、B两路视频源和相关配置。

使用自定义布局更新合流,代码示例请参见更新合流任务
查询合流查询在线合流列表和相关配置。DescribeMixStreamList
  • 返回在线合流列表。
  • 返回合流配置。
  • 返回合流创建时间、修改时间。
  • 返回合流播放地址。
查询合流任务
删除合流当您不需要使用某条合流后,请删除此条合流,否则合流将一直处于输出状态。DeleteMixStream删除合流任务

开发支持

您在使用合流服务过程中有任何问题或建议,请通过搜索群号34935990加入。