如何建立並使用普通模板 - Intelligent Media Services

普通模板是基於視訊剪輯工程的時間軸，其中包含多個素材，以多圖層形式進行前後拼接而建立。該模板可用於實現圖文轉視頻、圖片相簿、標題片尾、以及預設浮水印等效果。透過本文的閱讀，您可以瞭解如何建立並使用普通模板的方法。

建立普通模板

通過控制台建立

登入智能媒體服務控制台。
在左側導覽列選擇智能生產製作 > 雲剪輯，進入雲智能剪輯介面。
編輯剪輯工程並儲存後，在剪輯介面單擊產生為模版，或進入單擊操作列的匯出模板功能建立普通模板。
如果您需要編輯模板，請參見普通模板設計師手冊。

通過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，在合成作業時使用。

使用普通模板

通過控制台使用

登入智能媒體服務控制台。
在左側導覽列選擇智能生產製作 > 模板工廠，進入雲剪輯模板介面。
使用普通模板進行雲剪輯。
1. 單擊普通模板頁簽。
2. 單擊相應模板操作列的使用模板。
3. 輸入工程名稱，單擊確定，根據提示選擇是否現在編輯工程。關於如何編輯工程（普通剪輯），請參見剪輯功能介紹。

通過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());