普通模板Config詳解
通過配置TemplateId提交剪輯合成作業(yè)時,系統(tǒng)會將TemplateId對應的普通模板Config和傳入的參數(shù)ClipsParam合并成時間線Timeline,并根據(jù)此時間線進行剪輯合成。通過閱讀本文,您可以了解常見普通模板的Config和對應Timeline的詳細解析說明。
Config中的參數(shù)為普通參數(shù)示例
視頻添加水印
Config
| Timeline
|
解析說明:
普通模板Config中的參數(shù)字段以$開頭,例如上述Config示例代碼中的
"$Video"
。提交剪輯合成作業(yè)時,參數(shù)TemplateId傳入
IceSys_SingleVideo_Watermark
,ClipsParam傳入指定參數(shù)字段Video
,最終合并的時間線見上述Timeline示例代碼。http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob &TemplateID=IceSys_SingleVideo_Watermark &ClipsParam={\"Video\":\"****20b48fb04483915d4f2cd8ac****\"} &<公共參數(shù)>
視頻添加水印(Config中包含默認值)
Config
| Timeline
|
解析說明:
普通模板Config支持默認值,如果沒有傳入?yún)?shù)字段時,系統(tǒng)會使用默認值。例如上述Config示例代碼中的
"$TimelineIn:0"
、"$TimelineOut:NULL"
等,即冒號后面的值為該字段的默認值。如果默認值為NULL且沒有傳入該參數(shù)字段時,最終合成的Timeline會刪除該字段。
提交剪輯合成作業(yè)時,參數(shù)TemplateId傳入
IceSys_SingleVideo_Watermark
,ClipsParam傳入指定參數(shù)字段,最終合并的時間線見上述Timeline示例代碼。http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob &TemplateId=IceSys_SingleVideo_Watermark &ClipsParam={\"Video\":\"****20b48fb04483915d4f2cd8ac****\",\"TimelineIn\":\"5\"} &<公共參數(shù)>
Config中的參數(shù)為數(shù)組參數(shù)示例
視頻軌道整體靜音
Config
| Timeline
|
解析說明:
上述Config示例代碼中以下部分為數(shù)組參數(shù),方便傳入數(shù)量不定的素材。
{ "Sys_Type" : "ArrayItems", "Sys_ArrayObject" : "$VideoArray", "Sys_Template" : { "MediaId" : "$MediaId", "Effects": [ { "Type": "Volume", "Gain": "0" } ] } }
提交剪輯合成作業(yè)時,參數(shù)TemplateId傳入
IceSys_VideoMute
,ClipsParam傳入指定參數(shù)字段VideoArray(數(shù)組類型),合成Timeline時會遍歷VideoArray,以Sys_Template為模板生成每一個元素,并封裝成一個新的數(shù)組,最終合并的時間線見上述Timeline示例代碼。http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob &TemplateID=IceSys_VideoMute &ClipsParam={\"VideoArray\":[{\"MediaId\":\"******05512043f49f697f7425******\"},{\"MediaId\":\"******05512043f49f697f7425******\"},{\"MediaId\":\"******05512043f49f697f7425******\"}]} &<公共參數(shù)>
如果Sys_Template中只有一個參數(shù)時,可以簡化輸入?yún)?shù),即數(shù)組中每個元素不必指定參數(shù)名,只需傳入對應的值,最終合并的時間線和上述Timeline示例代碼一致。
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob &TemplateID=IceSys_VideoMute &ClipsParam={\"VideoArray\":[\"b3f37e05512043f49f697f7425b9188b\",\"9987d22788e810116a45109f2ea88648\",\"a8f5f167f44f4964e6c998dee827110c\"]} &<公共參數(shù)>
增加片頭片尾
Config
| Timeline
|
解析說明:
普通模板在視頻軌開始和結(jié)束分別插入固定的片頭和片尾,中間數(shù)組參數(shù)需要傳入數(shù)量不定的素材。提交剪輯合成作業(yè)時,參數(shù)TemplateId傳入IceSys_OpeningEnding
,ClipsParam傳入指定參數(shù)字段VideoArray(數(shù)組類型)。
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_OpeningEnding
&ClipsParam={\"VideoArray\":[\"******05512043f49f697f7425******\",\"******2788e810116a45109f2e******\",\"******67f44f4964e6c998dee8******\"]}
&<公共參數(shù)>
合成Timeline時會遍歷VideoArray,以Sys_Template為模板生成每一個元素,并封裝成一個新的數(shù)組,初步合成Timeline。此Timeline格式異常,因為VideoTrackClips中的中間項被處理成Clip數(shù)組,如下所示:
{
"VideoTracks": [
{
"VideoTrackClips": [
{
"MediaId": "******2788e810116a45109f2e******" // 此為設置的片頭視頻
},
[
{
"MediaId": "******05512043f49f697f7425******"
},
{
"MediaId": "******2788e810116a45109f2e******"
},
{
"MediaId": "******67f44f4964e6c998dee8******"
}
],
{
"MediaId": "******67f44f4964e6c998dee8******" // 此為設置的片尾視頻
}
]
}
]
}
鑒于此,智能媒體服務系統(tǒng)會做相應的容錯處理,根據(jù)當前上下文把數(shù)組中的元素提出并處理成一維數(shù)組,最終合并的時間線見上述Timeline示例代碼。