短視頻SDK提供了豐富的功能接?,產品級的交互,豐富的視頻素材庫(MV、貼紙、?泡、花字),并推出了特效?定義能?來滿足不同場景和?業下的素材需求,本?檔將重點介紹花字的制作規范和輸出。
簡介
花字是基于字幕的一種特效,一個花字特效資源包文件夾,包含了一個名為config.json的通用特效配置文件以及一些圖片素材。您可以通過短視頻SDK提供的編輯接口,傳入特效資源包文件夾目錄,來應用一個花字特效效果。
一個完整的花字特效資源包通常包含以下三個部分:
config.json:必選,花字的配置文件。配置說明參見config.json配置說明。
icon.png:可選,花字縮略圖,即最終生成的花字效果縮略圖。
lieheng.png:可選,花字文字貼圖,即基于此圖片設置花字效果,當配置文件有配置時使用。
配置花字特效資源包
config.json配置說明
字段 | 類型 | 是否必選 | 說明 |
version | String | 是 | 配置版本號,默認為1。 |
color | String | 是 | 字體顏色,格式:#AARRGGBB或 #RRGGBB。 |
texture | String | 否 | 花字文字貼圖,只支持jpg和png格式,且需和config.json配置文件放置在同一文件夾下。目前花字文字貼圖的規則是每個文字的貼圖完全一樣,取貼圖覆蓋到字體顏色區域部分。 |
outline1 | JSONObject | 是 | 第一層描邊。屬性說明參見outline屬性說明。 |
outline2 | JSONObject | 否 | 第二層描邊,和outline1數據結構相同。屬性說明參見outline屬性說明。 |
outline屬性說明
outline包含outline1和outline2。
字段 | 類型 | 是否必選 | 說明 |
type | String | 是 | 默認為normal,代表默認使用系統字體。 |
data | JSONArray | 是 | 定義了描邊的一系列顏色及寬度,詳細請參見data子節點屬性說明。 當type為normal時,data最多允許有3個顏色配置,超過3個,則只會取前3個顏色配置。 |
data子節點屬性說明
字段 | 類型 | 是否必選 | 說明 |
color | String | 是 | 描邊顏色,格式:#AARRGGBB或#RRGGBB。 |
width | float | 是 | 描邊寬度,取值范圍:[0~64],且下一個同類型節點的width值,必須大于當前width值。 說明 每一個outline的data子節點的width屬性值,必須大于上一個data子節點的width屬性值,示例如下。 |
正確的width取值樣例如下,data5的width > data4的width > data3的width > data2的width > data1的width。
{
"outline1": {
"type": "normal",
"data":[ // data1
{
"color": "#5350DD",
"width": 2
},
{ // data2
"color": "#B5FAA7",
"width": 4
}
]
},
"outline2": {
"type": "normal",
"data":[
{ // data3
"color": "#6E58F8",
"width": 8
},
{ // data4
"color": "#69F88C",
"width": 10
},
{ // data5
"color": "#FA55D8",
"width": 12
}
]
}
}
配置示例
本文以設置如下花字效果為例進行示例說明。該示例的配置資源包Demo:示例Demo.zip。
該示例Demo包的文件夾結構如下:
├── config.json
├── icon.png
└── lieheng.png
config.json的配置如下:
{ "version": 1, "color":"#000000", "texture": "lieheng.png", "outline1": { "type": "normal", "data":[ { "color": "#ffffff", "width": 8 } ] }, "outline2": { "type": "normal", "data":[ { "color": "#000000", "width": 15 } ] } }