You need to enable JavaScript to run this app.
导航
新增或更新点播播放器信息
最近更新时间:2024.06.25 12:10:43首次发布时间:2024.04.28 14:37:34

您可通过此接口新增点播播放器,或更新已有点播播放器的播放速度、跑马灯及全屏水印等信息。

使用说明

接口行为

  • 新增点播播放器:在请求参数中不传 VodPlayerConfigId(点播播放器 ID)或传入 VodPlayerConfigId 且参数取值为 0 ,即可新增点播播放器。
  • 更新点播播放器信息:在请求参数中传入待更新信息的点播播放器的 ID 作为 VodPlayerConfigId 参数值,即可更新该播放器信息。您可以通过 ListVodPlayerConfig 接口查询 ID。

注意事项

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

请求说明

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

请求参数

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

Query

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

Body

参数类型是否必选示例值描述
VodPlayerConfigObject of VodPlayerConfig-点播播放器配置信息。

VodPlayerConfig

参数类型是否必选示例值描述
ZoomConfigObject of ZoomConfig-画面缩放模式。
SpeedConfigObject of SpeedConfig-倍速挡位。
TickerConfigObject of TickerConfig-跑马灯相关配置。
WatermarkConfigObject of WatermarkConfig-全屏水印相关配置。
BasicConfigObject of BasicConfig-基础配置。

VodPlayerConfigId

String

vcid-1795893347583626

点播播放器 ID。

  • 新增点播播放器:不传该参数或传入该参数且取值为 0
  • 更新点播播放器信息:传入待更新信息的点播播放器 ID。您可以通过 ListVodPlayerConfig 接口查询 ID。
LogoConfigObject of LogoConfig-Logo 相关配置。

ZoomConfig

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

ZoomMode

Integer

1

画面缩放模式。支持以下取值:

  • 1:等比适配,即保持视频原有宽高比例填充点播播放器,视频的宽高会填满点播播放器的宽高。如果视频宽高比与点播播放器宽高比不同,视频会缩放显示。推荐在 PC 和手机横屏模式时使用该设置。
  • 2:等比填满,即保持视频原有宽高比例填充点播播放器,视频的宽高会填满点播播放器的宽高。如果视频宽高比与点播播放器宽高比不同,会有部分视频内容被裁剪掉。推荐在手机竖屏模式时使用该设置。
  • 3:拉伸填满,即视频内容完全填充点播播放器,但视频宽高比可能发生变化。

SpeedConfig

参数类型是否必选示例值描述
SpeedOptionString0.25,1.0,1.5,2.5倍速档位。观众仅可在您设置的范围内切换倍速。支持设置 [0.1,3] 区间的数字,且最多支持 2 位小数。最多支持 10 个倍速档位。

TickerConfig

参数类型是否必选示例值描述
ContentString跑马灯内容跑马灯内容。最多支持输入 20 个字符。

DisplayType

Integer

1

跑马灯的显示方式。支持以下取值:

  • 1:滚动,即在点播播放器内以碰撞反弹方式展示。
  • 2:闪烁,即在点播播放器内随机出现和消失。
FontColorString#ffffff跑马灯颜色。遵循 RGB 色彩模型。

FontSize

Integer

24

跑马灯字体的大小。支持以下取值:

  • 12
  • 16
  • 20
  • 24
  • 28
  • 32
  • 36
OpacityInteger10跑马灯字体的不透明度。取值范围为 [0,100]。

TickerSpeed

String

Moderate

跑马灯在点播播放器内滚动或闪烁的速度。支持以下取值:

  • Moderate:适中
  • Fast:较快
  • Slow:较慢

IsPlayPageTickerEnable

Integer

1

是否开启跑马灯功能。支持以下取值:

  • 0:关闭
  • 1:开启

WatermarkConfig

参数类型是否必选示例值描述
AngleInteger15水印的倾斜角度。取值范围为 [-90,90]。例如 Angle 取值为 15,表示向右上方倾斜 15 度;Angle 取值为 -15,表示向右下方倾斜 15 度。
ContentString水印内容全屏水印内容。最多支持输入 20 个字符。
FontColorString#737A87水印字体的颜色。遵循 RGB 色彩模型。

FontSize

Integer

24

水印字体的大小。支持以下取值:

  • 12
  • 16
  • 20
  • 24
  • 28
  • 32
  • 36
OpacityInteger10水印字体的不透明度。取值范围为 [0,100]。

IsPlayPageWatermarkEnable

Integer

1

是否开启全屏水印功能。支持以下取值:

  • 0:关闭
  • 1:开启

BasicConfig

参数类型是否必选示例值描述
VodPlayerNameString播放器名称点播播放器名称。最多支持输入 20 个字符。
BtnColorString#ffffff点播播放器内进度条、按钮、文字等控件的颜色。遵循 RGB 色彩模型。

LogoConfig

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

IsLogoEnable

Integer

1

是否开启 Logo 设置。支持以下取值:

  • 0:关闭
  • 1:开启

LogoPosition

Integer

1

图片在观看页的展示位置。支持以下取值:

  • 0:右上
  • 1:左上
  • 2:左下
  • 3:右下
LogoUrlStringhttp://example.comLogo 图片。需要带协议头。

返回参数

参数类型示例值描述
VodPlayerConfigIdStringvcid-1795893347583626新增或更新的点播播放器 ID。

请求示例

POST https://livesaas.volcengineapi.com/?Action=UpdateVodPlayerConfig&Version=2023-08-01
{
    "VodPlayerConfig": {
        "ZoomConfig": {
            "ZoomMode": 1
        },
        "SpeedConfig": {
            "SpeedOption": "0.25,1.0,1.5,2.5"
        },
        "TickerConfig": {
            "Content": "跑马灯内容",
            "DisplayType": 1,
            "FontColor": "#ffffff",
            "FontSize": 24,
            "Opacity": 10,
            "TickerSpeed": "Moderate",
            "IsPlayPageTickerEnable": 1
        },
        "WatermarkConfig": {
            "Angle": 15,
            "Content": "水印内容",
            "FontColor": "#737A87",
            "FontSize": 24,
            "Opacity": 10,
            "IsPlayPageWatermarkEnable": 1
        },
        "BasicConfig": {
            "VodPlayerName": "播放器名称",
            "BtnColor": "#ffffff"
        },
        "VodPlayerConfigId": "vcid-1795893347583626",
        "LogoConfig":{
            "IsLogoEnable": 1,
            "LogoPosition": 1,
            "LogoUrl":"http://example.com"
        }
    }
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202306041104200100100232280022D31",
        "Action": "UpdateVodPlayerConfig",
        "Version": "2023-08-01",
        "Service": "livesaas",
        "Region": "cn-north-1",
        "SystemTime": 1712067132
    },
    "VodPlayerConfigId": "vcid-1795893347583626"
}

错误码

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

状态码错误码错误信息说明
400InvalidParameter.InvalidAccountIdThe specified parameter AccountId is invalid.当前账号的鉴权信息错误。
400MissingParameter.VodPlayerConfigNotFoundThe required parameter VodPlayerConfig is missing.VodPlayerConfig 参数不存在。请修改后重试。
400MissingParameter.BasicConfigNotFoundThe required parameter BasicConfig is missing.BasicConfig 参数不存在。请修改后重试。
400MissingParameter.ZoomConfigNotFoundThe required parameter ZoomConfig is missing.ZoomConfig 参数不存在。请修改后重试。
400MissingParameter.SpeedConfigNotFoundThe required parameter SpeedConfig is missing.SpeedConfig 参数不存在。请修改后重试。
400MissingParameter.TickerConfigNotFoundThe required parameter TickerConfig is missing.TickerConfig 参数不存在。请修改后重试。
400MissingParameter.WatermarkConfigNotFoundThe required parameter WatermarkConfig is missing.WatermarkConfig 参数不存在。请修改后重试。
400MissingParameter.LogoConfigNotFoundThe required parameter LogoConfig is missing.LogoConfig 参数不存在。请修改后重试。