通常テンプレートの作成と使用 - Intelligent Media Services

通常テンプレートは、動画編集プロジェクトのタイムラインに基づいており、複数のレイヤーにまたがって結合された複数のメディアアセットが含まれます。通常テンプレートを使用して、テキストや画像を動画に変換したり、フォトアルバムを作成したり、オープニングやエンディングを生成したり、デフォルトのウォーターマークを適用したりすることができます。

通常テンプレートの作成

コンソールでの作成

Intelligent Media Services (IMS) コンソールにログインします。
左側のナビゲーションペインで、[インテリジェントプロダクション] > [オンライン編集] を選択して、オンライン編集ページを開きます。
動画編集プロジェクトを編集して保存した後、通常のテンプレートを作成するには、編集ページで[テンプレートを生成]をクリックするか、プロジェクトリストページの[操作]列で[テンプレートをエクスポート]をクリックします。

テンプレートの編集方法については、「通常テンプレートのデザイナーガイド」をご参照ください。

API での作成

通常テンプレートコンフィグをカスタマイズします。
通常テンプレートコンフィグは、オンライン編集プロジェクトのタイムラインに基づいており、高い柔軟性があります。テンプレートをカスタマイズするには、コンフィグの構造を理解する必要があります。詳細については、「通常テンプレートコンフィグの詳細」をご参照ください。

次の例は、動画結合テンプレートのコンフィグです。その他の例については、「一般的な通常テンプレートのコンフィグ例」をご参照ください。
```
{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "Sys_Type" : "ArrayItems",
                    "Sys_ArrayObject" : "$VideoArray",
                    "Sys_Template" : {
                        "MediaId" : "$MediaId"
                    }
                }
            ]
        }
    ]
}
```

通常テンプレートを作成します。

AddTemplate API を呼び出し、テンプレートコンフィグを渡します。

AddTemplateRequest request = new AddTemplateRequest();
request.setType("Timeline"); // 通常テンプレートの場合、Type を "Timeline" に設定します。
request.setName("Regular Template Test");
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 が返されます。この ID を使用して、制作タスクを送信できます。

通常テンプレートの使用

コンソールでの使用

Intelligent Media Services (IMS) コンソールにログインします。
左側のナビゲーションペインで、[インテリジェントプロダクション] > [テンプレートファクトリー] を選択して、テンプレートファクトリーページを開きます。
オンライン編集で通常テンプレートを使用します。
1. [標準テンプレート] タブをクリックします。
2. 目的のテンプレートを見つけ、[操作] 列の [テンプレートを使用] をクリックします。
3. プロジェクト名を入力し、[OK] をクリックします。プロンプトに従ってプロジェクトの編集を開始します。プロジェクトの編集方法 (通常編集) の詳細については、「編集機能」をご参照ください。

API での使用

テンプレート情報を取得します。
- コンソールから取得
  
  テンプレートがコンソールで作成された場合は、テンプレートファクトリーでそのテンプレートを探し、「操作」列で[テンプレートの編集]をクリックします。その後、[動的素材管理] 機能を使用してClipsParam パラメーターを構築します。
  
  パラメーターは、[ID 命名] の値をキー、置換テキストまたはメディアアセット ID を値として構築します。生成された ClipsParam パラメーターの例は次のとおりです。
```
{
 "1": "Replaced subtitle text",
 "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"
}
```
- API の呼び出しによる取得
  
  GetTemplate API を呼び出して、テンプレート情報を取得します。手順 2 でテンプレートを作成した際に返された template ID を渡します。
  
  レスポンスの ClipsParam フィールドは次のとおりです。
```
{"1":"text","2":"mediaId","3":"mediaId","4":"mediaId","5":"mediaId"}
```
  説明
  プリセットテンプレートを使用することもできます。手順は同様のため、ここでは説明を省略します。使用可能なプリセットテンプレートについては、「パブリックテンプレートライブラリの通常テンプレート」をご参照ください。
上記の例の ClipsParam パラメータ内のプレースホルダー text と mediaId の値を置き換えます。
```
{
 "1": "Replaced subtitle text",
 "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 URL に置き換えます。両方を組み合わせて使用することもできます。

制作タスクを送信します。

SubmitMediaProducingJob API を呼び出して、編集および制作タスクを送信します。 template ID と ClipsParam を渡します。

SubmitMediaProducingJobRequest request = new SubmitMediaProducingJobRequest();
request.setTemplateId("Your TemplateId");
request.setClipsParam("{\"1\":\"Replaced subtitle text\",\"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());