调用 UpdateActivityBasicConfigAPI 接口更新指定直播间的外观主题、自定义点赞特效图的 URL 等基础配置信息。

注意事项

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

请求说明

• 请求方式：POST
• 请求地址：https://livesaas.volcengineapi.com/?Action=UpdateActivityBasicConfigAPI&Version=2020-06-01

请求参数

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

Query

Body

SiteTags

TextSiteTags

RiskWarningSetting

返回参数

请求示例

POST https://livesaas.volcengineapi.com/?Action=UpdateActivityBasicConfigAPI&Version=2020-06-01
{
    "ActivityId": 1778****94933,
    "Name": "直播间 A",
    "LiveTime": 1698722520,
    "IsCoverImageEnable": 1,
    "CoverImageUrl": "//p1-live.example.com.image",
    "VerticalCoverImageUrl": "//p1-live.example.com.image",
    "IsPcBackImageEnable": 1,
    "PcBackImageUrl": "//p1-live.example.com.image",
    "PcBackImageUrlDefault": "//p1-live.example.com.image",
    "BackgroundColor": "#060815",
    "IsMobileBackImageEnable": 1,
    "MobileBackImageUrl": "//p1-live.example.com.image",
    "MobileBackImageUrlDefault": "//p1-live.example.com.image",
    "MobileBackgroundColor": "#060815",
    "PcLoginBackgroundImageUrl": "//p1-live.example.com.image",
    "MobileLoginBackgroundImageUrl": "//p1-live.example.com.image",
    "IsPreviewVideoEnable": 1,
    "PreviewVideoVid": "v03a49g10000ck****bc77uejmsbrgag",
    "PreviewVideoUrl": "",
    "PreviewVideoVidDefault": "",
    "IsPeopleCountEnable": 1,
    "IsHeaderImageEnable": 1,
    "HeaderImageUrl": "//p1-live.example.com.image",
    "IsWatermarkImageEnable": 1,
    "WatermarkImageUrl": "//p1-live.example.com.image",
    "IsThumbUpEnable": 1,
    "ThumbUpUrl": "https://p1-live.example.com.image",
    "ThumbUpUrlDefault": "https://p1-live.example.com.image",
    "IsShareIconEnable": 1,
    "ShareIconUrl": "//p1-live.example.com.image",
    "ShareIconUrlDefault": "https://p1-live.example.com.image",
    "IsCommentTranslateEnable": ,
    "IsAnnouncementEnable": 1,
    "Announcement": "直播简介",
    "InteractionColor": "#202124",
    "FontColor": "#ffffff",
    "ColorThemeIndex": "dark",
    "IsPCHeaderImageEnable": 1,
    "PCHeaderImageUrl": "//p1-live.example.com.image",
    "IsCountdownEnable": 1,
    "IsAutoStartEnable": 1,
    "AutoStartType": 1,
    "IsPageLimitEnable": 1,
    "PageLimitType": "pc",
    "IsLanguageEnable": 1,
    "LanguageType": [
        0,
        1
    ],
    "SiteTags": [
        {
            "Value": "分类标签值",
            "Index": 0
        }
    ],
    "TextSiteTags": [
        {
            "Value": "文本标签值",
            "Index": 0
        }
    ],
    "PreviewVideoId": 431674,
    "AccountId": ,
    "PreviewVideoReviewStatus": ,
    "DefaultSubtitleLanguage": "",
    "SourceSubtitleLanguage": "",
    "OpenLiveAvextractorTask": ,
    "IsTimeShift": 0,
    "PreviewVideoCoverImage": "http://p1-live.example.com.image",
    "PreviewVideoMediaName": "企业直播.mp4",
    "IsPreviewPromptEnable": 1,
    "PreviewPrompt": "直播即将开始，请稍候",
    "IsReservationEnable": 1,
    "ReservationTime": 300,
    "ReservationText": "",
    "WatermarkPosition": 0,
    "IsReplayBulletChat": ,
    "PresenterChatColor": "#FFD58B",
    "IsLiveBulletChat": ,
    "IsBackgroundBlur": 0,
    "FeedbackMessage": "",
    "IsFeedbackEnable": ,
    "IsThumbUpNumberEnable": 1,
    "SmsLanguage": 1,
    "MobileChatBackgroundColor": "#000000",
    "ConfigVersion": 1,
    "LiveZone": 480,
    "RiskWarningSetting": {
        "IsRiskWarningEnable": 1,
        "RiskWarningTitle": "风险提示",
        "RiskWarningContent": "欢迎来到直播间，请遵守国家法律法规的要求",
        "RiskWarningButtonText": "我已知悉"
    },
    "IsColorSync": 1,
    "IsPlayerTopEnable": 1,
    "PlayerTopType": [
        1,
        2
    ],
    "IsReplayAutoOnlineEnable": 0,
    "AutoReservationWindowEnable": 1,
    "IsReservationSmsEnable": 1,
    "UseDefaultThumbUpEffect": 1,
    "ThumbUpEffectUrls": [
        "//p1-live.example.com.image"
    ],
    "EndTime": 1718078834,
    "IsAutoEndEnable": 1,
    "IsAvatarShowEnable": 0
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "UpdateActivityBasicConfigAPI",
        "Version": "2020-06-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1697446406
    },
    "Result": {
        "ActivityId": 1778****94933,
        "Status": 0,
        "ActivityIdStr": "1778****94933"
    }
}

错误码

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