You need to enable JavaScript to run this app.
导航
企业直播
  • 文档首页
    • /企业直播/API 参考/直播间状态和直播频道配置/UpdateLiveChannelConfig - 更新直播频道
UpdateLiveChannelConfig - 更新直播频道
最近更新时间：2025.07.03 15:27:21首次发布时间：2024.07.02 09:25:51
复制全文
我的收藏
有用
有用
无用
无用

调用 UpdateLiveChannelConfig 接口，更新指定直播间中指定直播频道的配置信息。

说明

更新直播频道配置可能导致该频道的直播推流地址发生变化，因此更新配置后请通过 GetStreamsAPI 接口重新获取新的直播推流地址。

注意事项

  • 请求频率：单用户请求频率限制为 10 次/秒。
  • 前提条件：确保您拥有火山引擎主账号或具备直播间的直播控制 > 可编辑权限的子账号。有关如何添加子账号，详见子账号管理。

请求说明

  • 请求方式：POST
  • 请求地址：https://livesaas.volcengineapi.com/?Action=UpdateLiveChannelConfig&Version=2023-08-01

调试

API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
去调试

请求参数

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

Query

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

Body

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

ActivityId

Long

是

1783308668443

直播间 ID。您可以通过 ListActivityAPI 接口查询 ID。

说明

使用子账号调用接口时，确保该直播间对子账号可见。有关如何配置子账号的可见范围，详见子账号管理。

LineId

Long

否

341231

直播频道 ID。您可以通过 ListLiveChannelConfig 接口查询 ID。

说明

LineId 和 LineIndex 至少需要传一个，且同时传入时，LineId 的优先级更高。

LineIndex

Integer

否

1

直播频道的索引值。索引值越小,位置越靠前。取值范围为 [0,19]。

说明

LineId 和 LineIndex 至少需要传一个，且同时传入时，LineId 的优先级更高。

LineNameString否默认频道直播频道名称。最多支持输入 100 个字符。
CoverImageString否https://p1-live.example.com.webp直播频道封面图。需要包含协议头。

Resolution

Array of String

否

["sd","hd"]

频道的可选清晰度。观众仅可在您选择的范围内切换清晰度。清晰度越高，对网络环境要求越高。支持以下取值，默认选择 auto 且不支持删除。

  • origin：原画
  • bd：蓝光
  • uhd：超清
  • hd：高清
  • sd：标清
  • auto：智能

PCDefaultResolution

String

否

hd

PC 端观看页的智能清晰度。PC 端观众进入直播间时，将默认按照智能清晰度播放直播内容。支持以下取值：

  • origin：原画
  • bd：蓝光
  • uhd：超清
  • hd：高清
  • sd：标清

MobileDefaultResolution

String

否

hd

移动端观看页的智能清晰度。移动端观众进入直播间时，将默认按照智能清晰度播放直播内容。支持以下取值：

  • origin：原画
  • bd：蓝光
  • uhd：超清
  • hd：高清
  • sd：标清

MainBackupType

Integer

否

1

是否开启主备流功能。支持以下取值：

  • 1：开启，则企业直播会推送该频道的两路直播流至主地址和备地址，同时优先播放主地址的直播流。当主地址的推流断流后，可自动切换至备地址，以保证直播的稳定性。
  • 2：关闭

LlsType

Integer

否

1

是否开启超低延时功能。支持以下取值：

  • 1：开启，则选择该频道的观众可以 1 秒以内的超低延时观看直播内容。详见超低延时直播。
  • 2：关闭

TimeShiftType

Integer

否

1

是否开启直播时移功能。支持以下取值：

  • 1：开启，则选择该频道的观众可以拖动进度条跳转至 8 小时内任意过去时间点观看直播内容。详见直播时移。
  • 2：关闭

说明

开启多商品讲解功能期间，无法开启直播时移功能。

LineLanguage

String

否

cn

频道的页面默认语言。观看页可根据观众的 PC 端浏览器语言或移动端系统语言，判断默认播放哪个频道的直播内容。例如频道 A 的语言是简中，PC 端浏览器语言为简中的观众在进入直播间时，观看页会默认播放频道 A 的直播内容。支持以下取值：

  • cn：简中
  • en：英文
  • jp：日文
  • hant：繁中
  • ko：韩文
  • other：其他

返回参数

参数类型示例值描述
ActivityIdLong1783308668443直播间 ID。
LineIdLong341231直播频道 ID。
LineIndexInteger1直播频道索引值。
LineNameString默认频道直播频道名称。
CoverImageStringhttps://p1-live.example.com.webp直播频道封面图。

Resolution

Array of String

["sd","hd"]

频道的可选清晰度。支持以下取值：

  • origin：原画
  • bd：蓝光
  • uhd：超清
  • hd：高清
  • sd：标清
  • auto：智能

PCDefaultResolution

String

hd

PC 端观看页的智能清晰度。支持以下取值：

  • origin：原画
  • bd：蓝光
  • uhd：超清
  • hd：高清
  • sd：标清

MobileDefaultResolution

String

hd

移动端观看页的智能清晰度。支持以下取值：

  • origin：原画
  • bd：蓝光
  • uhd：超清
  • hd：高清
  • sd：标清

MainBackupType

Integer

1

是否开启主备流功能。支持以下取值：

  • 1：开启
  • 2：关闭

LlsType

Integer

1

是否开启超低延时功能。支持以下取值：

  • 1：开启
  • 2：关闭

TimeShiftType

Integer

1

是否开启直播时移功能。支持以下取值：

  • 1：开启
  • 2：关闭

LineLanguage

String

cn

频道的页面默认语言。支持以下取值：

  • cn：简中
  • en：英文
  • jp：日文
  • hant：繁中
  • ko：韩文
  • other：其他

请求示例

POST https://livesaas.volcengineapi.com/?Action=UpdateLiveChannelConfig&Version=2023-08-01
{
    "CoverImage": "https://p1-live.example.com.webp",
    "Resolution": [
        "sd",
        "hd"
    ],
    "PCDefaultResolution": "hd",
    "MobileDefaultResolution": "hd",
    "MainBackupType": 1,
    "LlsType": 1,
    "TimeShiftType": 1,
    "ActivityId": 1783308668443,
    "LineIndex": 1,
    "LineName": "默认频道"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "UpdateLiveChannelConfig",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1717269866
    },
    "Result": {
        "ActivityId": 1783308668443,
        "CoverImage": "https://p1-live.example.com.webp",
        "Resolution": [
            "sd",
            "hd"
        ],
        "PCDefaultResolution": "hd",
        "MobileDefaultResolution": "hd",
        "MainBackupType": 1,
        "LlsType": 1,
        "TimeShiftType": 1,
        "LineId": 341231,
        "LineIndex": 1,
        "LineName": "默认频道",
        "LineLanguage": "cn"
    }
}

错误码

下表提供了该接口特有的错误码，公共错误码请参见公共错误码和错误码文档。

状态码错误码错误信息说明
403OperationDenied.DeniedByMultiProductExplainOperation is denied because multi product explain and record product script/time shift cannot be enabled at the same time.开启多商品讲解功能期间，无法开启直播时移功能。请在调用 EnableActivityMultiProductExplain 接口将 IsMultiProductExplainEnable 的参数值设置为 0 后重试。
400OperationDenied.ActivityIsLivingCannot operate the live channel because the activity is living直播期间无法更新直播频道。请等待直播结束后重试。