全部产品
Search

搜索本产品

    视频直播：更新混流转推任务（新）

    文档中心

    视频直播：更新混流转推任务（新）

    更新时间：Mar 11, 2024

    调用UpdateLiveMPUTask更新混流转推任务。

    使用说明

    调用本接口前，您必须已经调用StartLiveMPUTask创建混流转推任务。

    QPS限制

    本接口的单用户QPS限制为500次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    请求参数

    名称

    类型

    是否必选

    示例值

    描述
    Action String 是 UpdateLiveMPUTask

    系统规定参数。取值：UpdateLiveMPUTask。
    AppId String 是 yourAppId

    应用ID，仅支持传单个ID。由大小写字母、数字、下划线、短划线（-）组成，最大64字符。
    ChannelId String 是 yourChannelId

    频道ID，仅支持传单个ID。由大小写字母、数字、下划线、短划线（-）组成，最大64字符。
    TaskId String 是 yourTaskId

    任务ID，仅支持传单个ID。由大小写字母、数字、下划线、短划线（-）组成，最大55字符。此ID为旁路转推的标识，需保证唯一。
    MixMode String 否 0

    混流模式。取值：

    • 0：单路转推，不混流转码，仅转推原始单路流，无需配置混流转码参数。
    • 1（默认值）：混流转码转推。
    StreamURL String 否 rtmp://example.com/live/stream

    直播推流地址，仅支持传单个地址。生成规则请参见推流地址和播放地址。

    说明
    • 对已开防盗链鉴权的域名，需要在推流地址中包含鉴权串。
    • 禁止同一个StreamURL在不同任务中同时使用。
    • 任务停止10S之内，禁止使用同一个StreamURL。
    SingleSubParams Object 否

    单流转推参数，单流转推（MixMode=0）时必填。
    UserId String 是 yourSubUserId

    转推用户ID，一次只能转推一路流。
    StreamType String 否 0

    单流转推模式下转推流类型。取值：

    • 0（默认值）：转推原始流。
    • 1：仅转推音频流。
    • 2：仅转推视频流。
    SourceType String 否 camera

    单流转推模式下视频输入流类型，仅针对视频流（StreamType=2）有效。取值：

    • camera（默认值）：摄像头。
    • shareScreen：屏幕共享。
    TranscodeParams Object 否

    混流转码转推参数，混流转码转推（MixMode=1）时必填。
    UserInfos Array 否

    混流用户信息，不指定用户则所有用户混流。
    UserId String 是 yourSubUserId

    混流用户ID。
    StreamType String 否 0

    混流转码模式下转推流类型。取值：

    • 0（默认值）：转推原始流。
    • 1：仅转推音频流。
    • 2：仅转推视频流。
    SourceType String 否 camera

    混流转码模模式下视频输入流类型，仅针对视频流（StreamType=2）有效。取值：

    • camera（默认值）：摄像头。
    • shareScreen：屏幕共享。
    EncodeParams Object 否

    转推输出的编码参数。
    AudioOnly String 否 false

    是否为纯音频，取值：

    • true：纯音频，仅需要设置音频相关参数。
    • false（默认值）：非纯音频，所有参数均不能为空。
    VideoWidth String 否 1920

    视频宽，取值范围：[0, 1920]，单位：px。
    VideoHeight String 否 1000

    视频高，取值范围：[0, 1920]，单位：px。
    VideoFramerate String 否 25

    视频帧率，取值范围：[1, 60]，单位：fps。
    VideoBitrate String 否 3500

    视频码率，取值范围：[1, 10000]，单位：kbps。
    VideoGop String 否 20

    视频GOP，取值范围：[1, 60]。
    AudioSampleRate String 否 44100

    音频采样率，取值：8000、16000、32000、44100、48000，单位：Hz。
    AudioBitrate String 否 128

    音频码率，取值范围：[8, 500]，单位：kbps。
    AudioChannels String 否 2

    音频声道数，取值：1、2。
    Layout Object 否

    视频布局信息。

    说明 音视频转码时，需要指定视频布局信息；纯音频转码时，禁止填写视频布局信息。
    UserPanes Array 否

    混流用户窗格信息。
    UserInfo Object 否

    该窗格对应的混流用户信息，不填时后台按照上行主播的进房顺序自动填充，仅针对原始流和视频流有效。
    UserId String 否 yourSubUserId

    混流用户ID。
    SourceType String 否 camera

    混流转码模模式下视频输入流类型，仅针对视频流（StreamType=2）有效。取值：

    • camera（默认值）：摄像头。
    • shareScreen：屏幕共享。
    X String 否 0.2456

    坐标X，归一化百分比。
    Y String 否 0.3789

    坐标Y，归一化百分比。
    Width String 否 0.3564

    窗格宽，归一化百分比。
    Height String 否 0.2632

    窗格高，归一化百分比。
    ZOrder String 否 0

    叠放顺序，0为最底层，1层在0层之上，以此类推。
    BackgroundImageUrl String 否 yourImageUrl

    子画面的背景图URL。当用户关闭摄像头或未进入房间时，会在布局位置填充为此图片。
    RenderMode String 否 1

    子画面输出时的显示模式，取值：

    • 0：缩放并显示黑底。
    • 1（默认值）：裁剪。
    Background Object 否

    混流全局背景图。
    URL String 否 yourImageUrl

    全局背景图URL。
    RenderMode String 否 1

    子画面输出时的显示模式：

    • 0：缩放并显示黑底。
    • 1（默认）：裁剪。
    SeiParams Object 否

    SEI配置参数。
    LayoutVolume Object 否

    布局和音量SEI，该参数内容可以为空，表示携带默认的布局和音量SEI。
    FollowIdr String 否 0

    发送IDR关键帧时是否确保携带SEI，取值：

    • 0：不确保带SEI。
    • 1：确保带SEI。
    Interval String 否 1000

    SEI发送间隔，取值范围：[1000, 5000]，单位：毫秒。
    PassThrough Object 否

    透传SEI。
    PayloadContentKey String 否 yourPayloadContentKey

    透传SEI的payload内容对应的key值。不设置时，key为默认值udd。
    PayloadContent String 否 yourPayloadContent

    透传SEI的payload内容。
    FollowIdr String 否 0

    发送IDR关键帧时是否确保携带SEI，取值：

    • 0：不确保带SEI。
    • 1：确保带SEI。
    Interval String 否 1000

    SEI发送间隔，取值范围：[1000, 5000]，单位：毫秒。

    返回数据

    名称

    类型

    示例值

    描述
    RequestId String 0F72851F-5DC1-1979-9B2C-450040316C3E

    请求ID。

    示例

    请求示例

    http(s)://live.aliyuncs.com/?Action=UpdateLiveMPUTask
&AppId=yourAppId
&ChannelId=yourChannelId
&TaskId=yourTaskId
&MixMode=0
&StreamURL=rtmp://example.com/live/stream
&SingleSubParams={"UserId":"yourSubUserId","StreamType":"0","SourceType":"camera"}
&TranscodeParams={"UserInfos":[{"UserId":"yourSubUserId","StreamType":"0","SourceType":"camera"}],"EncodeParams":{"AudioOnly":"false","VIdeoWidth":"1920","VIdeoHeight":"1080","VideoFramerate":"25","VideoBitrate":"3500","VideoGop":"20","AudioSampleRate":"44100","AudioBitrate":"128","AudioChannels":"2"},"Layout":{"UserPanes":[{"UserInfo":{"UserId":"yourSubUserId","SourceType":"camera"},"X":"0.2456","Y":"0.3789","Width":"0.3564","Height":"0.2632","ZOrder":"0","BackgroundImageUrl":"yourImageUrl","RenderMode":"1"}]},"Background":{"URL":"yourImageUrl","RenderMode":"1"}}
&SeiParams={"LayoutVolume":{"FollowIdr":"0","Interval":"1000"},"PassThrough":{"PayloadContentKey":"yourPayloadContentKey","PayloadContent":"yourPayloadContent","FollowIdr":"0","Interval":"1000"}}
&公共请求参数

    正常返回示例

    XML格式

    HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateLiveMPUTaskResponse>
    <RequestId>0F72851F-5DC1-1979-9B2C-450040316C3E</RequestId>
</UpdateLiveMPUTaskResponse>

    JSON格式

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0F72851F-5DC1-1979-9B2C-450040316C3E"
}

    错误码

    访问错误中心查看更多错误码。