本文旨在介绍高燃混剪成片的合成参数。
使用说明
将多个视频素材进行高燃混剪,一键批量合成视频接口说明,请参见SubmitScreenMediaHighlightsJob - 提交高燃混剪任务,API关键参数详见下文InputConfig 参数说明、EditingConfig 参数说明、OutputConfig 参数说明。
获取批量智能一键成片作业的详细信息,请参见GetBatchMediaProducingJob - 获取批量智能一键成片任务信息。
InputConfig 参数说明
用户可通过配置InputConfig,指定视频素材、口播、背景音乐、贴纸等基础素材的参数配置。
参数 | 类型 | 说明 | 是否必填 |
MediaArray | List<String> | 影视剧素材,仅支持视频。支持传入媒资ID或素材OSS URL列表,视频总时长最多两小时,数量上限20。 | 是 |
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 | 高光集锦部分的片头配置
| 否 |
Media 参数说明
参数 | 数据类型 | 说明 | 是否必填 |
MediaId | String | 媒资ID | 二选一必填 都填写时优先取用MediaId |
MediaURL | String | 媒资URL,仅支持自有OSS | |
In | Float | 当素材为视频时,表示素材入点 | 否 |
Out | Float | 当素材为视频时,表示素材出点 | 否 |
Duration | Float | 当素材是图片时,表示素材展示的时长 | 否 |
DyncFrames | Integer | 当素材为gif格式时,表示动图的帧数 | 否 |
SubHeading 参数说明
参数 | 类型 | 说明 | 是否必填 |
Level | Integer | 副标题级别。 枚举:
| 是 |
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 | 输入视频素材相关配置。 支持字段:
| 否 |
TitleConfig | JSON | 标题相关配置。支持配置字幕参数,字段详见:横幅文字。 | 否 |
SubHeadingConfig | JSON | JSON说明: key:Level value:横幅文字 示例如下:
| 否 |
BackgroundMusicConfig | JSON | 背景音乐相关配置。 支持字段:
| 否 |
BackgroundImageConfig | JSON | 背景图相关配置。如果InputConfig中已配置背景图,则此字段不生效。 支持字段:
| 否 |
ProcessConfig | 混剪处理配置。 支持字段:
| ||
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 |
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、背景音乐和背景图片的配置。