通过配置Timeline提交剪辑合成作业时，您需要根据实际业务需求配置此参数。通过阅读本文，您可以了解配置文字叠加相关功能的Timeline示例。
使用说明
以下示例中的参数详情，请参见通用参数字段说明。
Timeline示例
全程叠加文字
全程叠加文字指从视频开始到结束全程叠加文字。全程叠加不需要指定TimelineIn和TimelineOut，文字在输出视频中出现的位置由横幅文字特效中的坐标X和Y设定。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "****6f9bdb68419abfd36a7113cf****",
"Effects": [
{
"Type": "Text",
"X": 31,
"Y": 93,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "测试文字",
"FontSize": 26,
"FontColorOpacity": 0.2,
"FontColor": "#000000",
"FontFace": {
"Bold": true,
"Italic": false,
"Underline": false
}
},
{
"Type": "Text",
"X": 30,
"Y": 92,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "测试文字",
"FontSize": 26,
"FontColorOpacity": 1,
"FontColor": "#FFFFFF"
},
{
"Type": "Text",
"X": 0.8123,
"Y": 0.7896,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "测试文字",
"FontSize": 26,
"FontColorOpacity": 0.2,
"FontColor": "#000000"
},
{
"Type": "Text",
"X": 0.8223,
"Y": 0.7796,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "测试文字",
"FontSize": 26,
"FontColorOpacity": 1,
"FontColor": "#FFFFFF"
}
]
}
]
}
]
}指定时间区域叠加文字
指定时间区域叠加文字指文字叠加在视频指定的时间区域。文字在输出视频中出现的位置由横幅文字特效中的坐标X和Y设定。例如，在视频的第0秒~5秒、第5秒~10秒叠加文字。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "****6f9bdb68419abfd36a7113cf****",
"Effects": [
{
"Type": "Text",
"X": 31,
"Y": 93,
"TimelineIn": 0,
"TimelineOut": 5,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "测试文字",
"FontSize": 26,
"FontColorOpacity": 0.2,
"FontColor": "#000000",
"FontFace": {
"Bold": true,
"Italic": false,
"Underline": false
}
},
{
"Type": "Text",
"X": 30,
"Y": 92,
"TimelineIn": 0,
"TimelineOut": 5,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "测试文字",
"FontSize": 26,
"FontColorOpacity": 1,
"FontColor": "#FFFFFF"
},
{
"Type": "Text",
"X": 1124,
"Y": 516,
"TimelineIn": 5,
"TimelineOut": 10,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "测试文字",
"FontSize": 26,
"FontColorOpacity": 0.2,
"FontColor": "#000000"
},
{
"Type": "Text",
"X": 1123,
"Y": 515,
"TimelineIn": 5,
"TimelineOut": 10,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "测试文字",
"FontSize": 26,
"FontColorOpacity": 1,
"FontColor": "#FFFFFF"
}
]
}
]
}
]
}外挂字幕
在字幕轨道中放置外挂字幕文件（支持.ass和.srt格式的字幕文件），将字幕合成到成片视频中。
{
"VideoTracks":[
{
"VideoTrackClips":[
{
"MediaId":"****756620ed48c9af022c66ee2e****"
}
]
}
],
"SubtitleTracks":[
{
"SubtitleTrackClips":[
{
"Type":"Subtitle",
"SubType":"srt",
"FileURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/object.srt"
}
]
}
]
}花字样式
花字是基于横幅文字特效的一种特殊的文本字幕样式。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "MediaId1",
"Effects": [
{
"Type": "Text",
"X": 33,
"Y": 34,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "带阴影带边框花字-第一段测试文字",
"OutlineColour": "#ee00ff",
"BackColour": "#CE1212",
"EffectColorStyle": "skyline",
"Angle": 300,
"Outline": 2,
"Shadow": 3,
"FontSize": 42,
"FontColorOpacity": 1,
"FontColor": "#000000",
"FontFace": {
"Bold": true,
"Italic": false,
"Underline": false
}
},
{
"Type": "Text",
"X": 66,
"Y": 256,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "第二段文字",
"EffectColorStyle": "golden",
"Angle": 60,
"FontSize": 38,
"FontColorOpacity": 0.8,
"FontColor": "#d60e0e"
},
{
"Type": "Text",
"X": 0.7123,
"Y": 0.7896,
"TimelineIn": 5,
"TimelineOut": 20,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "第三段文字",
"FontSize": 26,
"FontColor": "#000000"
}
]
}
]
}
]
}花字参数字段说明
参数字段 | 类型 | 描述 |
EffectColorStyle | string | 花字样式类型。更多花字样式和效果，请参见花字效果示例。 |
OutlineColour | string | 描边颜色，使用6位十六进制RGB值表示，格式为#xxyyzz。 |
BackColour | string | 阴影颜色，使用6位十六进制RGB值表示，格式为#xxyyzz。 |
Shadow | int | 花字阴影深度的像素值，默认为0。推荐缩放比为2∶25，例如，字体大小设置为25号，则阴影深度设置为2。 |
Outline | int | 花字描边宽度的像素值，默认为0。推荐缩放比为2∶25，例如，字体大小设置为25号，则描边宽度设置为2。 |
Spacing | int | 花字字体之间的间距，单位为像素。 |
Angle | float | 字幕行预先旋转过的角度，取值范围：[0,360]。 |
视频添加换行字幕并设置对齐方式
通过添加\n或\\n实现换行，添加Alignment属性设置对齐方式。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "MediaId3",
"Effects": [
{
"Type": "Text",
"X": 20,
"Y": 34,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "在Content中添加\n来实现换行，Alignment设置TopCenter来实现字幕换行后居中对齐",
"Alignment": "TopCenter",
"FontSize": 26,
"FontColorOpacity": 1,
"FontColor": "#ff0000",
"FontFace": {
"Bold": true,
"Italic": false,
"Underline": false
}
},
{
"Type": "Text",
"X": 100,
"Y": 200,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "在Content中添加\n来实现换行，Alignment设置TopLeft来实现字幕换行后左对齐",
"Alignment": "TopLeft",
"FontSize": 26,
"FontColorOpacity": 0.8,
"FontColor": "#ff0000"
},
{
"Type": "Text",
"X": 0.10,
"Y": 0.1,
"TimelineIn": 2,
"TimelineOut": 15,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "在Content中添加\n来实现换行，Alignment设置TopRight来实现字幕换行后右对齐",
"Alignment": "TopRight",
"FontSize": 26,
"FontColor": "#000000"
}
]
}
]
}
]
}字幕特效＋花字效果
通过添加EffectColorStyle属性设置花字效果，同时需要设置描边宽度和阴影颜色。更多花字效果示例，请参见花字效果示例。
{
"VideoTracks": [{
"VideoTrackClips": [{
"MediaId": "MediaId1",
"Effects": [{
"Type": "Text",
"X": 33,
"Y": 34,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "brushed_aluminium花字，rotateflip_in入场特效，slide_down_out出场特效",
"OutlineColour": "#4effcf",
"BackColour": "#2effc6",
"Outline": 2,
"Shadow": 2,
"EffectColorStyle": "brushed_aluminium",
"FontSize": 42,
"AaiMotionInEffect": "rotateflip_in",
"AaiMotionIn": 1,
"AaiMotionOutEffect": "slide_down_out",
"AaiMotionOut": 1,
"FontFace": {
"Bold": true,
"Italic": false,
"Underline": false
}
},
{
"Type": "Text",
"X": 66,
"Y": 256,
"Font": "WenQuanYi Zen Hei Mono",
"Content": "deep_sea花字，rainbrush_display循环特效，快速循环",
"EffectColorStyle": "deep_sea",
"OutlineColour": "#e9e9e9",
"BackColour": "#30335c",
"Outline": 2,
"Shadow": 2,
"AaiMotionLoopEffect": "rainbrush_display",
"Ratio": 2,
"FontSize": 38,
"FontColorOpacity": 0.8,
"FontColor": "#d60e0e"
}
]
}]
}]
}设置字幕特效时，循环特效不能与入场、出场特效共存，且入场、出场特效优先级高于循环特效。
直接使用字幕文件进行剪辑
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "MediaId1"
},
{
"MediaId": "MediaId3"
}
]
}
],
"SubtitleTracks": [
{
"SubtitleTrackClips": [
{
"Type": "Subtitle",
"SubType": "srt",
"FileUrl": "http://your-bucket.oss-cn-shanghai.aliyuncs.com/your-subtitle.srt"
}
]
}
]
}使用自有版权字体进行字幕制作
通过FontUrl属性添加自有版权的字体文件OSS地址，支持TTF、OTF、WOFF格式。
{
"VideoTracks": [{
"VideoTrackClips": [{
"MediaId": "MediaId1",
"Effects": [{
"Type": "Text",
"X": 33,
"Y": 34,
"Content": "使用自定义字体",
"FontSize": 42,
"FontUrl": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_font.ttf"
}]
}]
}]
}设置自有版权字体时，无需再设置字体Font属性。如果同时设置，系统会按照自有版权字体设置字幕。
智能字幕
通过设置"Type": "AI_ASR"，系统会根据视频或音频中的声音生成字幕。
{
"VideoTracks": [{
"VideoTrackClips": [{
"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video7.mp4",
"Effects": [{
"Type": "AI_ASR",
"Font": "AlibabaPuHuiTi",
"Alignment": "TopCenter",
"Y": 910,
"Outline": 10,
"OutlineColour": "#ffffff",
"FontSize": 60,
"FontColor": "#000079",
"FontFace": {
"Bold": true,
"Italic": false,
"Underline": false
}
}]
}]
}]
}设置字幕纯色背景
通过设置"BorderStyle": 3，同时设置边框宽度Outline和边框颜色OutlineColour，实现设置字幕纯色背景。
{
"VideoTracks": [{
"VideoTrackClips": [{
"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your_video.mp4",
"Effects": [{
"Type": "Text",
"X": 33,
"Y": 34,
"Content": "设置字幕纯色背景",
"FontSize": 42,
"BorderStyle": 3,
"FontColor": "#4B0082",
"Outline": 3,
"OutlineColour": "#FFDEAD"
}]
}]
}]
}设置官方气泡字
通过设置"BubbleStyleId"，可以实现给字幕加气泡的效果，您可以同时替换"Content"更改气泡字文本，文本内容会在您设置的"BubbleWidth"或者"BubbleHeight"（如果不设置，气泡大小默认为0.3倍的输出成片尺寸）中自动换行并自动缩放，使用气泡字效果的同时也支持使用花字效果以及字幕动效。使用气泡字时"X"、"Y"表示整个气泡相对视频左上角的坐标。
{
"VideoTracks": [{
"VideoTrackClips": [{
"MediaURL": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/background.png",
"Type": "Image",
"Duration": 1
}]
}],
"SubtitleTracks": [{
"SubtitleTrackClips": [{
"Type": "Text",
"Alignment": "TopCenter",
"BubbleStyleId": "BS0001-000001",
"X": 0.1,
"Y": 0.1,
"BubbleWidth": 0.8,
"Content": "气泡字效果"
}]
}]
}通用参数字段说明
参数类别 | 参数字段及描述 |
文字在视频中的坐标 |
说明 X、Y坐标支持百分比和像素两种形式：
|
文字本身属性 |
|
文字叠加在视频中的时间区域 |
说明 如果设置的TimelineOut超过视频结束时间，则TimelineOut以实际视频结束时间为准。 |
- 本页导读 （1）