You need to enable JavaScript to run this app.
导航
更新云端混流任务
最近更新时间:2024.09.12 19:49:58首次发布时间:2024.06.24 10:59:27

调用 UpdateCloudMixTask 接口,更新运行中的云端混流任务。

注意事项

请求频率:单用户请求频率限制为 10 次/秒

请求说明

  • 请求方式:POST
  • 请求地址:https://live.volcengineapi.com?Action=UpdateCloudMixTask&Version=2023-01-01

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

Query

参数类型是否必选示例值描述
ActionStringUpdateCloudMixTask接口名称。当前 API 的名称为 UpdateCloudMixTask
VersionString2023-01-01接口版本。当前 API 的版本为 2023-01-01

Body

参数类型是否必选示例值描述
TaskIDString3b1a7bb73ab6b06c混流任务 ID,您可以通过 ListCloudMixTask 接口获取运行中的混流任务 ID。
MixedRulesObject of MixedRules-混流任务详细配置。

MixedRules

参数类型是否必选示例值描述
InputSourceArray of InputSource-混流素材列表,最多支持配置 8 路输入源。
InputLayoutObject of InputLayout-混流输出布局配置。

Output

Object of Output

-

混流输出流参数配置。

注意

更新云端混流任务时,Output 参数不支持变更,且必须传入与原混流任务一致的配置。

InputSource

参数类型是否必选示例值描述
IDString1混流素材 ID,一个任务中素材 ID 不能重复,此 ID 用于任务状态回调消息中标识素材。

Layer

Integer

1

混流素材的叠放顺序,1 为最底层,2 层在 1 层之上,以此类推,取值范围为[1,9999]。

说明

当前准备使用某个素材作为布局背景时,其叠放顺序应设置为所有素材中的最小值。

Type

String

vod

混流素材类型,支持的取值及含义如下所示。

  • vod:视频点播中的素材,支持 MP4、FLV 格式素材;
  • live:直播源素材,支持 RTMP、FLV 协议拉流地址;
  • pic:图片素材,支持 png、jpg 格式图片。
UrlStringhttps://tos.example.org/obj/test.mp4混流素材访问地址。

InputLayout

参数类型是否必选示例值描述
SceneObject of Scene-混流输出画布配置和素材布局配置。

Logo

Array of Logo

-

混流输出视频中 Logo 布局配置。

说明

支持最多配置 4 个 Logo,展示层级以添加顺序为准。

Output

参数类型是否必选示例值描述
VideoObject of Video-混流画面参数设置。
AudioObject of Audio-混流声音参数设置。
UrlArray of String["push.example.com","push2.example.com"]混流视频的推流地址。

Scene

参数类型是否必选示例值描述
HeightInteger1080混流输出整体画布高度,单位为 px,取值范围为 [10,2160]。
WidthInteger1920混流输出画布整体宽度,单位为 px,取值范围为 [10,2160]。

Layout

Array of Layout

-

混流素材在混流输出整体画面中的布局配置。

说明

混流素材布局中需包含所有素材的配置,且需与通过 Layer 参数与混流素材一一匹配。

参数类型是否必选示例值描述
UrlStringhttp://tos.example.org/obj/test/logo001.pngLogo 图片访问地址。
LayoutObject of Layout-Logo 图片在混流输出整体画面中的布局配置。

Video

参数类型是否必选示例值描述
BitRateInteger8000000混流输出视频码率,单位为 bps,取值范围为 [1000000,20000000],输入值小于或大于取值范围时会进行自动修正至最小值和最大值。
FrameRateInteger30混流输出视频帧率,单位为 fps,取值范围为 [10,60],输入值小于或大于取值范围时会进行自动修正至最小值和最大值。
GOPInteger2IDR 帧之间的最大间隔时间,单位为秒,取值范围为 [1,10]。

Codec

String

h264

混流输出视频编码格式,支持的取值及含义如下所示。

  • h264:使用 H.264 编码格式;
  • h265:使用 H.265 编码格式。

Audio

参数类型是否必选示例值描述

BitRate

Integer

320000

混流输出流的音频码率,单位为 bps,取值范围为 [128000,320000],常见取值及含义如下所示。

  • 128000:128 kbps;
  • 144000:144 kbps;
  • 256000:256 kbps;
  • 320000:320 kbps。

ChannelLayout

String

stereo

混流输出流的音频声道设置,取值及含义如下所示。

  • mono:单声道;
  • stereo:立体声。

SampleRate

Integer

48000

混流输出流的音频采样率,单位为 HZ,常见取值及含义如下所示。

  • 32000:32 kHZ;
  • 44100:44.1 kHZ;
  • 48000:48 kHZ。

Layout

参数类型是否必选示例值描述
XInteger0当前素材或 Logo 图片在输出画面中相对画面左上角的 X 偏移位置,单位为 px,取值范围为 0 到设置的画面宽度。
YInteger0当前素材或 Logo 图片在输出画面中相对画面左上角的 Y 偏移位置,单位为 px,取值范围为 0 到设置的画面高度。
WInteger960当前素材或 Logo 图片在混流输出画面中的限制宽度,单位为 px,取值范围为 [10,2160]。

H

Integer

540

当前素材或 Logo 图片在混流输出画面中的限制高度,单位为 px,取值范围为 [10,2160]。

说明

限制宽度和限制高度指定了素材展示的限制范围,当素材尺寸和限制值不一致时,素材将在限制范围内根据长边进行等比缩放,其余区域透明展示。

Layer

Integer

1

当配置素材布局时需要通过 Layer 参数与素材进行一一对应。

说明

配置 Logo 图片的布局时此参数不生效。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见返回结构

参数类型示例值描述

Code

Integer

0

请求响应码,取值及含义如下。

  • 0:请求成功;
  • 500:内部处理错误;
  • 400:请求异常。
MessageStringsuccess请求响应码对应的信息。
DataObject of Data-返回的数据。

Data

参数类型示例值描述
OptIDInteger2任务版本标识符,用来标识更新后的任务版本。

请求示例

POST https://live.volcengineapi.com?Action=UpdateCloudMixTask&Version=2023-01-01
{
    "TaskID": "3b1a7bb73ab6b06c",
    "MixedRules": {
        "InputLayout": {
            "Scene": {
                "Height": 1080,
                "Width": 1920,
                "Layout": [
                    {
                        "X": 0,
                        "Y": 0,
                        "W": 960,
                        "H": 540,
                        "Layer": 1
                    }
                ]
            },
            "Logo": [
                {
                    "Layout": {
                        "X": 0,
                        "Y": 0,
                        "W": 200,
                        "H": 200
                    },
                    "Url": "http://tos.example.org/obj/test/logo001.png"
                }
            ]
        },
        "Output": {
            "Audio": {
                "BitRate": 320000,
                "ChannelLayout": "stereo",
                "SampleRate": 48000
            },
            "Url": [
                "push.example.com",
                "push2.example.com"
            ],
            "Video": {
                "BitRate": 8000000,
                "FrameRate": 30,
                "GOP": 2,
                "Codec": "h264"
            }
        },
        "InputSource": [
            {
                "ID": "1",
                "Layer": 1,
                "Type": "vod",
                "Url": "https://tos.example.org/obj/test.mp4"
            }
        ]
    }
}

返回示例

{
    "ResponseMetadata": {
        "RequestID": "20240313141021EE8F4F695569E8031641",
        "Action": "UpdateCloudMixTask",
        "Version": "2023-01-01",
        "Service": "live",
        "Region": "cn-north-1"
    },
    "Result": {
        "Code": 0,
        "Message": "success",
        "Data": {
            "OptID": 2
        }
    }
}

错误码

您可访问公共错误码,获取更多错误码信息。