普通模板是基于視頻剪輯工程的時間線,其中包含多個素材,以多圖層形式進行前后拼接而創建。該模板可用于實現圖文轉視頻、圖片相冊、片頭片尾、以及默認水印等效果。透過本文的閱讀,您可以了解如何創建并使用普通模板的方法。
創建普通模板
通過控制臺創建
登錄智能媒體服務控制臺。
在左側導航欄選擇
,進入云智能剪輯界面。編輯剪輯工程并保存后,在剪輯界面單擊生成為模板,或進入單擊操作列的導出模板功能創建普通模板。
如果您需要編輯模板,請參見普通模板設計師手冊。
通過OpenAPI創建
自定義普通模板Config。
普通模板Config是基于云剪輯Timeline的封裝,而自定義模板Config則提供了更加靈活的選擇。如果您有特殊需求,我們建議您熟悉Config結構并進行自定義模板的設置。詳情請參見普通模板Config詳解。
以下以視頻拼接模板Config舉例說明。更多模板Config示例,請參見常見普通模板Config示例。
{ "VideoTracks": [ { "VideoTrackClips": [ { "Sys_Type" : "ArrayItems", "Sys_ArrayObject" : "$VideoArray", "Sys_Template" : { "MediaId" : "$MediaId" } } ] } ] }
創建普通模板。
調用AddTemplate創建模板,傳入模板Config。
AddTemplateRequest request = new AddTemplateRequest(); request.setType("Timeline"); //普通模板Type取值為Timeline request.setName("普通模板測試"); request.setConfig("{\"VideoTracks\":[{\"VideoTrackClips\":[{\"Sys_Type\":\"ArrayItems\",\"Sys_ArrayObject\":\"$VideoArray\",\"Sys_Template\":{\"MediaId\":\"$MediaId\"}}]}]}"); AddTemplateResponse response = iceClient.addTemplate(request); System.out.println("templateId : " + response.getBody().getTemplate().getTemplateId());
創建成功后會返回模板ID,在合成作業時使用。
使用普通模板
通過控制臺使用
登錄智能媒體服務控制臺。
在左側導航欄選擇
,進入云剪輯模板界面。使用普通模板進行云剪輯。
單擊普通模板頁簽。
單擊相應模板操作列的使用模板。
輸入工程名稱,單擊確定,根據提示選擇是否現在編輯工程。關于如何編輯工程(普通剪輯),請參見視頻剪輯。
通過OpenAPI使用
獲取模板信息。
通過控制臺獲取
如果模板由控制臺創建,可在模板工廠中單擊對應模板操作列的編輯模板,通過模板可變素材管理功能拼接生成
ClipsParam
。拼接規則為:ID命名為key,需要替換的文案或媒資ID為value。則上述對應拼接生成的
ClipsParam
示例如下所示:{ "1": "替換后的字幕", "2": "****20b48fb04483915d4f2cd8ac****", "3": "****20b48fb04483915d4f2cd8ac****", "4": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video1.mp4", "5": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video2.mp4" }
調用OpenAPI獲取
調用GetTemplate獲取模板信息,并傳入創建普通模板步驟 2生成的
TemplateId
。返回結果中
ClipsParam
字段如下所示:{"1":"text","2":"mediaId","3":"mediaId","4":"mediaId","5":"mediaId"}
說明您也可以使用系統內置模板,使用方式與上述使用個人創建模板類似,不再重復介紹。系統內置模板請參見公共模板庫——普通模板。
根據實際需求替換以上步驟示例中
ClipsParam
參數的text
和mediaId
字段。{ "1": "替換后的字幕", "2": "****20b48fb04483915d4f2cd8ac****", "3": "****20b48fb04483915d4f2cd8ac****", "4": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video1.mp4", "5": "https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-video2.mp4" }
說明ClipsParam
為合成服務的參數,您可以根據實際需求替換text為指定的文案,替換mediaId為指定的媒資ID或對應的OSS地址(包括視頻和圖片),支持混合使用。調用合成服務。
調用SubmitMediaProducingJob提交剪輯合成作業,傳入
TemplateId
和ClipsParam
。SubmitMediaProducingJobRequest request = new SubmitMediaProducingJobRequest(); request.setTemplateId("Your TemplateId"); request.setClipsParam("{\"1\":\"替換的字幕\",\"2\":\"****20b48fb04483915d4f2cd8ac****\",\"3\":\"****20b48fb04483915d4f2cd8ac****\",\"4\":\"****20b48fb04483915d4f2cd8ac****\",\"5\":\"****20b48fb04483915d4f2cd8ac****\"}"); request.setOutputMediaConfig("{\"MediaURL\":\"http://your-bucket.oss-cn-shanghai.aliyuncs.com/object.mp4\"}"); SubmitMediaProducingJobResponse response = iceClient.submitMediaProducingJob(request); System.out.println("jobid : " + response.getBody().getJobId());