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

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

说明
  • 云端合流目前处于公测阶段。无需开通即可使用，且暂不收费。
  • 每个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加入。