本文為您介紹通過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]。 |