通常テンプレートの作成と使用の概要 - Intelligent Media Services (IMS)

標準テンプレートは、動画編集プロジェクトのタイムラインに基づいて作成され、複数レイヤーモードでマージされた複数の素材を含んでいます。標準テンプレートを使用すると、画像やテキストを動画に変換する、フォトアルバムを生成する、イントロ動画やアウトロ動画をデザインする、デフォルトのウォーターマークを適用するなどの効果を実現できます。このトピックでは、標準テンプレートを作成および使用する方法について説明します。

標準テンプレートの作成

IMSコンソールを使用する

Intelligent Media Services (IMS) コンソールにログインします。
左側のナビゲーションペインで、[インテリジェントプロダクション] > [オンライン編集] を選択します。
[動画編集プロジェクト] タブで、編集する動画編集プロジェクトを見つけ、[アクション] 列の [編集] をクリックします。表示されたページで、動画編集プロジェクトを編集して保存します。次に、[テンプレートの生成] をクリックして、標準テンプレートを作成します。また、[動画編集プロジェクト] タブの [アクション] 列にある [テンプレートのエクスポート] をクリックして、標準テンプレートを作成することもできます。
標準テンプレートの編集方法の詳細については、「標準テンプレートの編集ガイドライン」をご参照ください。

APIオペレーションを呼び出す

標準テンプレートの Config オブジェクトをカスタマイズします。
標準テンプレートの Config オブジェクトは、オンライン編集プロジェクトの Timeline オブジェクトに基づいてカプセル化されています。カスタムテンプレートの Config オブジェクトは、より柔軟な機能を提供します。特殊な要件がある場合は、Config オブジェクトの構造を理解し、カスタムテンプレートを設定することをお勧めします。詳細については、「標準テンプレートの Config オブジェクト」をご参照ください。
次のサンプルコードは、動画マージテンプレートの Config オブジェクトを示しています。 Config オブジェクトの例の詳細については、「基本的なテンプレート設定」をご参照ください。
```
{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "Sys_Type" : "ArrayItems", // 配列アイテムのタイプ
                    "Sys_ArrayObject" : "$VideoArray", // 配列オブジェクトの名前
                    "Sys_Template" : { // テンプレートオブジェクト
                        "MediaId" : "$MediaId" // メディアID
                    }
                }
            ]
        }
    ]
}
```

標準テンプレートを作成します。

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 が返されます。テンプレート ID は、制作タスクに使用できます。

標準テンプレートの使用

IMSコンソールを使用する

IMS コンソールにログインします。
左側のナビゲーションペインで、[インテリジェントプロダクション] > [テンプレートファクトリー] を選択します。
標準テンプレートを使用してオンライン編集を実行します。
1. [共通テンプレート] タブをクリックします。
2. 使用するテンプレートを見つけて、[アクション] 列の [テンプレートの使用] をクリックします。
3. 表示されたダイアログボックスで、プロジェクト名を入力し、[OK] をクリックします。表示されるメッセージで、[OK] または [キャンセル] をクリックして、プロジェクトをすぐに編集するかどうかを決定します。標準編集プロジェクトの編集方法の詳細については、「オンライン編集」トピックの「動画編集」セクションをご参照ください。

APIオペレーションを呼び出す

テンプレート情報を取得します。
- IMSコンソールを使用する
  テンプレートが IMS コンソールで作成された場合は、[テンプレートファクトリー] ページの [共通テンプレート] タブでテンプレートを見つけ、[アクション] 列の [テンプレートの編集] をクリックします。表示されるページで、[動的マテリアル管理] タブを使用して、ClipsParam パラメーターを生成します。
  ClipsParam パラメーターの値は、キーと対応する値で構成されます。 [ID の命名] パラメーターはキーであり、置き換えられるテキストまたはメディアアセット ID は値です。次のサンプルコードは、生成された 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"
}
```
- APIオペレーションを呼び出す
  GetTemplate オペレーションを呼び出してテンプレート情報を取得し、このトピックの「APIオペレーションを呼び出す」セクションの手順 2 で取得したテンプレート ID を指定します。
  次のサンプルコードは、レスポンス内の ClipsParam パラメーターの値を示しています。
```
{"1":"text","2":"mediaId","3":"mediaId","4":"mediaId","5":"mediaId"}
```
  説明
  プリセットテンプレートを使用することもできます。プリセットテンプレートを使用する方法は、前述のユーザー作成テンプレートを使用する方法と似ており、このトピックでは説明しません。プリセットテンプレートの詳細については、「パブリックテンプレートライブラリの標準テンプレート」をご参照ください。
上記のサンプルコードの上記のサンプルコードの textmediaIdClipsParam パラメーターで、フィールドとフィールドをビジネス要件に基づいて設定します。フィールドとフィールドを、ビジネス要件に基づいてパラメーターで設定します。
```
{
 "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 または動画や画像の Object Storage Service (OSS) ストレージアドレスに置き換えることができます。制作サービスリクエストで text フィールドと mediaId フィールドの両方を設定することで、テキストとマルチメディア要素を含む動画を作成できます。

本番サービスを呼び出します。

SubmitMediaProducingJob オペレーションを呼び出して編集および制作タスクを送信し、TemplateId パラメーターと ClipsParam パラメーターを指定します。

SubmitMediaProducingJobRequest request = new SubmitMediaProducingJobRequest();
request.setTemplateId("Your TemplateId"); // テンプレートIDを設定
request.setClipsParam("{\"1\":\"置き換えられた字幕。\",\"2\":\"****20b48fb04483915d4f2cd8ac****\",\"3\":\"****20b48fb04483915d4f2cd8ac****\",\"4\":\"****20b48fb04483915d4f2cd8ac****\",\"5\":\"****20b48fb04483915d4f2cd8ac****\"}"); // ClipsParamを設定
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());