文字疊加
本文為您介紹通過OpenAPI進(jìn)行視頻剪輯時文字疊加場景的Timeline常用配置示例,包括全程疊加文字、指定區(qū)域疊加文字等示例。
相關(guān)API
參數(shù)說明
參數(shù) | 說明 |
文字出現(xiàn)的坐標(biāo) |
支持百分比和像素兩種形式:
|
文字本身屬性 |
|
文字在輸出視頻疊加的時間區(qū)間 |
|
Timeline示例
全程疊加文字
全程疊加文字指從片頭到片尾疊加文字,即視頻全程疊加文字不需要指定TimelineIn
和TimelineOut
,文字在輸出視頻中出現(xiàn)的位置由X
和Y
設(shè)定。示例如下:
{
"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"
}
]
}
]
}
]
}
指定區(qū)域疊加文字
指定區(qū)域疊加文字指文字疊加在視頻的指定時間區(qū)間,文字在輸出視頻中出現(xiàn)的位置由X
和Y
設(shè)定。在一個視頻的第0~5、5~10秒疊加文字,示例如下:
當(dāng)
TimelineIn
不設(shè)置時,默認(rèn)從0開始。當(dāng)
TimelineOut
不設(shè)置時,默認(rèn)到視頻的尾部。當(dāng)
TimelineOut
超過視頻尾部(對單視頻來說,即視頻時長)時,超過的時間區(qū)間自動被忽略,仍以視頻軌的尾部為準(zhǔn)。
{
"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"
}
]
}
]
}
]
}
花字參數(shù)字段說明
參數(shù)字段 | 類型 | 描述 |
EffectColorStyle | string | 花字樣式類型。更多花字樣式和效果,請參見花字效果示例。 |
OutlineColour | string | 描邊顏色,使用6位十六進(jìn)制RGB值表示,格式為#xxyyzz。 |
BackColour | string | 陰影顏色,使用6位十六進(jìn)制RGB值表示,格式為#xxyyzz。 |
Shadow | int | 花字陰影深度的像素值,默認(rèn)為0。推薦縮放比為2∶25,例如,字體大小設(shè)置為25號,則陰影深度設(shè)置為2。 |
Outline | int | 花字描邊寬度的像素值,默認(rèn)為0。推薦縮放比為2∶25,例如,字體大小設(shè)置為25號,則描邊寬度設(shè)置為2。 |
Spacing | int | 花字字體之間的間距,單位為像素。 |
Angle | float | 字幕行預(yù)先旋轉(zhuǎn)過的角度,取值范圍:[0,360]。 |