高燃混剪成片

本文旨在介绍高燃混剪成片的合成参数。

使用说明

InputConfig 参数说明

用户可通过配置InputConfig,指定视频素材、口播、背景音乐、贴纸等基础素材的参数配置。

参数

类型

说明

是否必填

MediaArray

List<String>

影视剧素材,仅支持视频。支持传入媒资ID或素材OSS URL列表,视频总时长最多两小时,数量上限20。

HighlightStrategy

HighlightStrategy

高燃混剪策略。

OpeningArray

List<Media>

固定片头,每次合成随机选一个,支持传入媒资ID或素材OSS URL列表,数量上限20。

EndingArray

List<Media>

固定片尾,每次合成随机选一个,支持传入媒资ID或素材OSS URL列表,数量上限20。

TitleArray

List<String>

标题,每次合成随机选一个

最多50个,每个标题不超过20字

SubHeadingArray

List<SubHeading>

副标题,最多5级。

StickerArray

List<Sticker>

贴纸数组,每次合成随机选一个,

最多50个。

BackgroundMusicArray

List<String>

背景音乐,每次合成随机选一个。

最多50个,支持媒资ID 或 OSS URL。

BackgroundImageArray

List<String>

背景图片,每次合成随机选择一个。

最多50个,支持媒资ID 或 OSS URL。

HighlightStrategy 参数说明

参数

数据类型

说明

是否必填

IntroConfig

JSON

高光集锦部分的片头配置

  • Mode: 选取模式,默认为Auto

    • Auto: 自动选取最高能片段作为开头

    • Disabled:不额外添加开头

Media 参数说明

参数

数据类型

说明

是否必填

MediaId

String

媒资ID

二选一必填

都填写时优先取用MediaId

MediaURL

String

媒资URL,仅支持自有OSS

In

Float

当素材为视频时,表示素材入点

Out

Float

当素材为视频时,表示素材出点

Duration

Float

当素材是图片时,表示素材展示的时长

DyncFrames

Integer

当素材为gif格式时,表示动图的帧数

SubHeading 参数说明

参数

类型

说明

是否必填

Level

Integer

副标题级别。

枚举:

  • 1:一级副标题

  • 2:二级副标题

  • 3:三级副标题

  • 4:四级副标题

  • 5:五级副标题

TitleArray

List<String>

副标题数组,每次合成随机选一个,

最多50个,每个标题不超过50字。

Sticker 参数说明

参数

类型

说明

是否必填

MediaId

String

贴纸、logo、水印等图片ID

二选一必填

都填写时优先取用MediaId

MediaURL

String

图片URL,仅支持自有OSS

X

Float

参考VideoTrackClip.X

Y

Float

参考VideoTrackClip.Y

Width

Float

参考VideoTrackClip.Width

Height

Float

参考VideoTrackClip.Height

DynamicFrames

Integer

动图的帧数

否,贴纸为动图时填写

Opacity

Float

透明度

否,默认1,范围[0,1]

参数示例

{
  "MediaArray": [
    "https://******.oss-cn-shanghai.aliyuncs.com/test%20demo/%E5%88%AB%E8%B7%9F%E5%A7%90%E5%A7%90%E6%92%92%E9%87%8E/17097_1466980429_%E9%87%91%E5%B0%8F%E5%A7%90%EF%BC%8C%E4%BD%A0%E7%9B%B8%E4%BF%A1%E4%B8%80%E8%A7%81%E9%92%9F%E6%83%85%E5%90%97%EF%BC%9F.mp4",
    "https://******.oss-cn-shanghai.aliyuncs.com/test%20demo/%E5%88%AB%E8%B7%9F%E5%A7%90%E5%A7%90%E6%92%92%E9%87%8E/17097_1467191403_%E8%B0%81%E8%A6%81%E6%8E%A5%E5%8F%97%E5%A9%9A%E5%A7%BB%E4%B8%8A%E7%9A%84%E4%B8%8D%E5%AE%8C%E7%BE%8E%E5%91%A2%EF%BC%9F.mp4",
    "https://******.oss-cn-shanghai.aliyuncs.com/test%20demo/%E5%88%AB%E8%B7%9F%E5%A7%90%E5%A7%90%E6%92%92%E9%87%8E/17097_1466982579_%E6%8B%92%E7%BB%9D%E7%BB%93%E5%A9%9A%E6%9C%89%E4%B8%89%E4%B8%AA%E7%90%86%E7%94%B1%EF%BC%9F.mp4",
    "https://******.aliyuncs.com/test%20demo/%E5%88%AB%E8%B7%9F%E5%A7%90%E5%A7%90%E6%92%92%E9%87%8E/17097_1466984862_%E9%A1%BE%E5%90%8C%E5%AD%A6%E7%9A%84%E6%B1%82%E5%A9%9A%E5%A4%A7%E4%BD%9C%E6%88%98.mp4"
  ],
  "HighlightStrategy": {
    "IntroConfig": {
      "Mode": "Auto"
    }
  },
  "OpeningArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "EndingArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "In": 0,
      "Out": 5
    },
    {
      "MediaId": "****9d46c8b4548661030f6e****",
      "In": 0,
      "Out": 5
    }
  ],
  "TitleArray": [
    "回龙观盒马鲜生开业啦",
    "盒马鲜生开业啦"
  ],
  "SubHeadingArray": [
    {
      "Level": 1,
      "TitleArray": [
        "副标题1",
        "副标题2"
      ]
    },
    {
      "Level": 3,
      "TitleArray": [
        "三级副标题"
      ]
    }
  ],
  "StickerArray": [
    {
      "MediaId": "****9d46c8b4548681030f6e****",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300,
      "Opacity": 0.6
    },
    {
      "MediaURL": "http://test-bucket.oss-cn-shanghai.aliyuncs.com/test3.png",
      "X": 10,
      "Y": 100,
      "Width": 300,
      "Height": 300
    }
  ],
  "BackgroundMusicArray": [
    "****b4549d46c88681030f6e****",
    "****549d46c88b4681030f6e****",
    "http://test-bucket.oss-cn-shanghai.aliyuncs.com/test4.mp3"
  ],
  "BackgroundImageArray": [
    "****6c886b4549d481030f6e****",
    "****9d46c8548b4681030f6e****",
    "http://test-bucket.oss-cn-shanghai.aliyuncs.com/test1.png"
  ]
}

EditingConfig 参数说明

用户可通过配置EditingConfig,指定成片素材的音量、位置及其他合成参数。

参数

类型

说明

是否必填

MediaConfig

JSON

输入视频素材相关配置。

支持字段:

  • Volume: 输入视频的音量,默认0。取值:[0, 10.0],支持小数,例:0.5。

  • MediaMetaDataArray: 媒资meta信息列表。单个MediaMetaData包含以下字段

    • Media: 媒资ID 或 OSS URL,需和InputConfig 中传入的素材保持一致。

    • TimeRangeList:入出点范围列表,每个素材支持指定多段入出点,从中选取片段合成。单个TimeRange字段如下:

      • In:素材入点

      • Out:素材出点

TitleConfig

JSON

标题相关配置。支持配置字幕参数,字段详见:横幅文字

SubHeadingConfig

JSON

JSON说明:

key:Level

value:横幅文字

示例如下:

{
    "1": {
      "Y": 0.3,
      "FontSize": 40
    },
    "3": {
      "Y": 0.5,
      "FontSize": 30
    }
  }

BackgroundMusicConfig

JSON

背景音乐相关配置。

支持字段:

  • Volume:背景音乐的音量,默认0.2。取值:[0, 10.0],支持小数,例:0.5。

  • Style:背景音乐风格,默认为空。若InputConfig中已配置背景音乐,此字段不生效。取值:

    • "bgm-beauty":时尚

    • "bgm-chinese-style":中国风

    • "bgm-cuisine":美食

    • "bgm-dynamic":动感

    • "bgm-quirky":怪诞

    • "bgm-relaxing":轻松

    • "bgm-romantic":浪漫

    • "bgm-upbeat":欢快

BackgroundImageConfig

JSON

背景图相关配置。如果InputConfig中已配置背景图,则此字段不生效。

支持字段:

  • SubType:背景类型。取值:

    • "Color":纯色背景

    • "Blur":背景模糊

  • Radius:模糊半径,当SubType=Blur时,此参数生效,取值范围[0.01, 1]

  • Color:背景颜色。SubType=Color时,此参数生效,16进制RGB颜色,例:#000000。

ProcessConfig

混剪处理配置。

支持字段:

  • AllowVfxEffect:是否允许添加特效效果,默认false。

  • VfxEffectProbability:特效应用在每个视频片段上的概率,默认0.5,取值:0.0 - 1.0,支持2位小数。

  • AllowTransition:是否允许添加转场效果,默认false。

  • TransitionList:自定义转场效果列表,当AllowTransition=true时,随机选取列表中的一个转场效果进行合成。例:["directional", "linearblur"]

  • UseUniformTransition:单个成片中是否使用一致的转场效果,默认true。

ProduceConfig

JSON

普通剪辑合成配置,字段详见:EditingProduceConfig

参数示例

{
  "MediaConfig": {
    "Volume": 0 // 默认视频素材静音
  },
  "TitleConfig": {
    "Alignment": "TopCenter",
    "AdaptMode": "AutoWrap",
    "Font": "Alibaba PuHuiTi 2.0 95 ExtraBold",
    "SizeRequestType": "Nominal",
    "Y": 0.1, // 成片为竖屏时,标题Y坐标值
    "Y": 0.05, // 成片为横屏时,标题Y坐标值
    "Y": 0.08 // 成片为方屏时,标题Y坐标值
  },
   "SubHeadingConfig": {
    "1": {
      "Y": 0.3,
      "FontSize": 40
    },
    "3": {
      "Y": 0.5,
      "FontSize": 30
    }
  },
  "BackgroundMusicConfig": {
    "Volume": 0.2,   // 背景音乐默认用20%音量,
    "Style": null
  },
  "ProcessConfig": {
    "AllowVfxEffect": false,	  // 是否添加特效效果
    "AllowTransition": false,	  // 是否添加转场效果
  }
}

OutputConfig 参数说明

用户可通过配置OutputConfig,指定成片输出地址、名称规则、成片的宽高、输出成片数量等合成参数。

参数

类型

必填

说明

MediaURL

String

成片输出到OSS时必填

输出视频地址,必须要有占位符

如:http://xxx.oss-cn-shanghai.aliyuncs.com/xxx_{index}.mp4

StorageLocation

String

成片输出到VOD时必填

指定输出到VOD的媒资文件存储地址

如:outin-xxxxxx.oss-cn-shanghai.aliyuncs.com

FileName

String

成片输出到VOD时必填

输出文件名称,必须要有占位符,

如:xxx_{index}.mp4

GeneratePreviewOnly

Boolean

否,默认false

GeneratePreviewOnly = true时,表示当前任务仅生成预览用的时间线,不实际合成,可不填写输出视频的地址。

一键成片任务完成后,通过GetBatchMediaProducingJob查询任务结果,返回的子任务列表中会包含剪辑工程projectId,再调用GetEditingProject可获取到预览时间线。

Count

Integer

否,默认1

输出视频数,当前版本只能为1。

Width

Integer

成片宽,px

Height

Integer

成片高,px

Video

JSONObject

输出视频流相关配置,Crf、Codec等

参数示例

{
 	"MediaURL": "http://xxx.oss-cn-shanghai.aliyuncs.com/xxx_{index}.mp4",
 	"Count": 1,
 	"Width": 1080,
 	"Height": 1920,
 	"Video": {"Crf": 27},
        "GeneratePreviewOnly":false
}

处理逻辑

  • 根据MediaArray配置剪辑素材,对素材进行分析时应按照素材的顺序进行处理。

  • 根据HighlightStrategy配置高燃集锦部分的片头和片尾。

  • 根据OpeningArray和EndingArray来配置高燃集锦部分之前的固定开头(前贴片)、之后的固定结尾(后贴片)。

  • 根据TitleArray、SubHeadingArray、StickerArray、BackgroundMusicArray及BackgroundImageArray进行标题、副标题、贴图logo、背景音乐和背景图片的配置。

相关文档