全部产品
视频直播

开启多人连麦服务

更新时间:2017-09-19 11:32:58   分享:   

描述

开启多人连麦服务:

  • 调用该接口时主流必须存在并且收到混流可用回调 [MixAvailableNotification] 的时候开始调用,否则该调用会失败。
  • 该接口仅用来设置混流相关参数,调用后,主流的画面不会出现改变。
  • 若对正在混流的主流调用该接口,则所有当前的混流效果将会结束,即在这种情况下,系统会自动调用 StopMultipleStreamMixService。

请求参数

参数 类型 是否必须 描述
Action String 操作接口名,系统规定参数,取值:StartMultipleStreamMixService
DomainName String 您的加速域名
AppName String 直播流所属应用名称
StreamName String 直播的流名
MixTemplate String 混流所使用的布局模板,系统预设值: pip4a

返回参数

名称 类型 描述
RequestId String 该条任务请求 ID

特殊错误码

错误代码 描述 Http 状态码 语义
InvalidDomain.NotFound The domain provided does not exist in our records. 404 当前账户下未查到域名
MissingDomainName DomainName is mandatory for this action. 400 缺少 DomainName 值
MissingAppName AppName is mandatory for this action. 400 缺少 AppName 值
MissingStreamName StreamName is mandatory for this action. 400 缺少 StreamName 值
MissingMixTemplate MixTemplate is mandatory for this action. 400 缺少 MixTemplate 值
InvalidStream.NotPublish Specified stream is not publishing. 400 未推流
InvalidStream.NotConfig Specified stream does not config. 400 此流未进行混流配置
InternalError The request processing has failed due to some unknown error, exception or failure. 500 内部错误

示例

请求示例:

  1. https://live.aliyuncs.com?Action=StartMultipleStreamMixService&DomainName=live.aliyunlive.com&AppName=xxx&StreamName=user1&MixTemplate=pip4a<公共请求参数>

关于公共请求参数详细内容,请参考 公共请求参数

返回示例

JSON格式:

  1. {
  2. "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8",
  3. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?