本文为您介绍通过OpenAPI进行视频剪辑时文字叠加场景的Timeline常用配置示例，包括全程叠加文字、指定区域叠加文字等示例。
相关API
参数说明
参数 | 说明 |
文字出现的坐标 |
支持百分比和像素两种形式：
|
文字本身属性 |
|
文字在输出视频叠加的时间区间 |
|
Timeline示例
全程叠加文字
全程叠加文字指从片头到片尾叠加文字，即视频全程叠加文字不需要指定TimelineIn和TimelineOut，文字在输出视频中出现的位置由X和Y设定。示例如下：
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
"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秒叠加文字，示例如下：
当
TimelineIn不设置时，默认从0开始。当
TimelineOut不设置时，默认到视频的尾部。当
TimelineOut超过视频尾部（对单视频来说，即视频时长）时，超过的时间区间自动被忽略，仍以视频轨的尾部为准。
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
"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"
}
]
}
]
}
]
}花字样式
花字是基于横幅文字特效的一种特殊的文本字幕样式。示例如下：
{
"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]。 |