文档

云端合流概述

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

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

说明
  • 云端合流目前处于公测阶段。无需开通即可使用,且暂不收费。

  • 每个UID下并发合流任务上限为10路,如需扩充请提交工单。关于如何提交工单,请参见联系我们

  • 云端合流目前仅支持华北2和华东2地区。

功能特性

功能

描述

特性

多路合流

将多路视频源推至直播中心,合流为一路直播流。

  • 支持添加RTMP、FLV和ARTC协议的直播流。

    说明

    超低延时直播使用协议为ARTC。

  • 支持添加文件流。

  • 最多添加8个视频源。

预设布局

提供预设的合成直播流画面布局,满足不同场景下的直播。

提供7种预设布局,布局请参见合流预设布局参考

自定布局

根据需要,添加自定义合成后直播流的布局。

支持设置窗格个数、尺寸和位置。

合流输出

将合流的多路视频源以直播流的形式输出。

支持自定义合流输出域名,可用该域名观看合流后的内容。

合流查询

查询当前合流任务列表及相应配置信息。

支持实时查询。

合流更新

在合流观看过程中更新视频源、合流布局,且无缝切换。

不支持更新输出分辨率等内容。

自动删除

自动删除合流任务。

支持在创建合流任务时设定自动删除时间,到期合流任务自动删除以节省流量,默认为7天。

重要

在合流创建成功后不可再修改。

合流回调

合流任务状态回调。

支持在创建合流时向您的回调地址发送创建成功或创建失败的消息,以便让您及时获取合流任务创建的结果。

使用方法

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

image

具体调用方法和参数请参见如下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加入。

  • 本页导读 (1)
文档反馈