通常テンプレートの設定オブジェクト - Intelligent Media Services

TemplateId パラメーターを指定して編集および制作タスクを送信すると、Intelligent Media Services（IMS）は、TemplateId パラメーターで指定された通常テンプレートの Config オブジェクトと、ClipsParam パラメーターで指定された設定をマージして Timeline オブジェクトを作成します。その後、Timeline オブジェクトを使用してビデオを編集および制作できます。このトピックでは、通常テンプレートの Config オブジェクトのサンプルと、対応する Timeline オブジェクトについて説明します。

共通パラメーターが使用される Config オブジェクトのサンプル

ビデオにウォーターマークを追加する

設定

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "$Video" // 使用するビデオ素材の ID
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******", // ウォーターマークとして使用する画像素材の ID
                    "Width" : 200, // ウォーターマークの幅
                    "Height" : 60, // ウォーターマークの高さ
                    "X" : 40, // ウォーターマークの水平方向の位置
                    "Y" : 40 // ウォーターマークの垂直方向の位置
                }
            ]
        }
    ]
}

タイムライン

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "****20b48fb04483915d4f2cd8ac****" // 使用するビデオ素材の ID
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******", // ウォーターマークとして使用する画像素材の ID
                    "Width" : 200, // ウォーターマークの幅
                    "Height" : 60, // ウォーターマークの高さ
                    "X" : 40, // ウォーターマークの水平方向の位置
                    "Y" : 40 // ウォーターマークの垂直方向の位置
                }
            ]
        }
    ]
}

説明:

通常テンプレートの Config オブジェクトのパラメーター値は、$ で始まります。例：上記のサンプル Config オブジェクトの "$Video"。
編集および制作タスクを送信する場合は、TemplateId パラメーターを IceSys_SingleVideo_Watermark に設定し、Video を ClipsParam パラメーターの設定に追加します。生成される Timeline オブジェクトの詳細については、上記のサンプル Timeline オブジェクトをご参照ください。
```
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_SingleVideo_Watermark
&ClipsParam={\"Video\":\"****20b48fb04483915d4f2cd8ac****\"}
&<共通パラメーター>
```

ビデオにウォーターマークを追加する（Config オブジェクトでデフォルトパラメーター値がサポートされています）

設定

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "$Video" // 使用するビデオ素材の ID
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******", // ウォーターマークとして使用する画像素材の ID
                    "Width" : 200, // ウォーターマークの幅
                    "Height" : 60, // ウォーターマークの高さ
                    "X" : "$X:40", // ウォーターマークの水平方向の位置。デフォルト値は 40 です。
                    "Y" : "$Y:40", // ウォーターマークの垂直方向の位置。デフォルト値は 40 です。
                    "TimelineIn" : "$TimelineIn:0", // ウォーターマークを表示開始する時刻。デフォルト値は 0 です。
                    "TimelineOut" : "$TimelineOut:NULL" // ウォーターマークを表示終了する時刻。デフォルト値は NULL です。
                }
            ]
        }
    ]
}

タイムライン

{
    "VideoTracks": [
        {  
            "VideoTrackClips": [
                {    
                    "MediaId": "****20b48fb04483915d4f2cd8ac****" // 使用するビデオ素材の ID
                }
            ]
        }
    ],
    "ImageTracks": [
        {
            "ImageTrackClips": [
                {
                    "ImageId": "******e01cb05d417c3dbcd1b9******", // ウォーターマークとして使用する画像素材の ID
                    "Width" : 200, // ウォーターマークの幅
                    "Height" : 60, // ウォーターマークの高さ
                    "X" : 40, // ウォーターマークの水平方向の位置
                    "Y" : 40, // ウォーターマークの垂直方向の位置
                    "TimelineIn" : 5 // ウォーターマークを表示開始する時刻
                }
            ]
        }
    ]
}

説明:

通常テンプレートの Config オブジェクトでは、デフォルトパラメーター値がサポートされています。パラメーターを指定しない場合、IMS はパラメーターのデフォルト値を使用します。例：上記のサンプル Config オブジェクトの "$TimelineIn:0" と "$TimelineOut:NULL"。コロン（:）の後の値は、TimelineIn パラメーターと TimelineOut パラメーターのデフォルト値です。
パラメーターのデフォルト値が NULL で、パラメーターを指定しない場合、パラメーターは生成された Timeline オブジェクトから削除されます。
編集および制作タスクを送信する場合は、TemplateId パラメーターを IceSys_SingleVideo_Watermark に設定し、Video を ClipsParam パラメーターの設定に追加します。生成される Timeline オブジェクトの詳細については、上記のサンプル Timeline オブジェクトをご参照ください。
```
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateId=IceSys_SingleVideo_Watermark
&ClipsParam={\"Video\":\"****20b48fb04483915d4f2cd8ac****\",\"TimelineIn\":\"5\"}
&<共通パラメーター>
```

配列パラメーターが使用される Config オブジェクトのサンプル

ビデオトラック全体をミュートする

設定

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "Sys_Type" : "ArrayItems", // 配列要素を示します。
                    "Sys_ArrayObject" : "$VideoArray", // 配列オブジェクトを示します。
                    "Sys_Template" : { // 配列要素のテンプレートを示します。
                        "MediaId" : "$MediaId", // ビデオ素材の ID
                        "Effects": [ // エフェクトのリスト
                            {
                                "Type": "Volume", // エフェクトのタイプ。値は Volume です。
                                "Gain": "0" // 音量ゲイン。値は 0 です。
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

タイムライン

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId" : "******05512043f49f697f7425******", // ビデオ素材の ID
                    "Effects": [ // エフェクトのリスト
                        {
                            "Type": "Volume", // エフェクトのタイプ。値は Volume です。
                            "Gain": "0", // 音量ゲイン。値は 0 です。
                        }
                    ]
                },
                {
                    "MediaId" : "******2788e810116a45109f2e******", // ビデオ素材の ID
                    "Effects": [ // エフェクトのリスト
                        {
                            "Type": "Volume", // エフェクトのタイプ。値は Volume です。
                            "Gain": "0", // 音量ゲイン。値は 0 です。
                        }
                    ]
                },
                {
                    "MediaId" : "******67f44f4964e6c998dee8******", // ビデオ素材の ID
                    "Effects": [ // エフェクトのリスト
                        {
                            "Type": "Volume", // エフェクトのタイプ。値は Volume です。
                            "Gain": "0", // 音量ゲイン。値は 0 です。
                        }
                    ]
                }
            ]
        }
    ]
}

説明:

上記のサンプル Config オブジェクトの次のセクションでは、配列ベースの構造を使用して、$VideoArray で定義された可変数の素材に対応しています。

{
    "Sys_Type" : "ArrayItems", // 配列要素を示します。
    "Sys_ArrayObject" : "$VideoArray", // 配列オブジェクトを示します。
    "Sys_Template" : { // 配列要素のテンプレートを示します。
        "MediaId" : "$MediaId", // ビデオ素材の ID
        "Effects": [ // エフェクトのリスト
            {
                "Type": "Volume", // エフェクトのタイプ。値は Volume です。
                "Gain": "0" // 音量ゲイン。値は 0 です。
            }
        ]
    }
}

編集および制作タスクを送信する場合は、TemplateId パラメーターを IceSys_VideoMute に設定し、VideoArray を ClipsParam パラメーターの設定に追加します。Timeline オブジェクトを生成するために、IMS は VideoArray パラメーターをトラバースし、Sys_Template オブジェクトを使用して要素を生成し、要素を新しい配列にカプセル化します。生成される Timeline オブジェクトの詳細については、上記のサンプル Timeline オブジェクトをご参照ください。

http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_VideoMute
&ClipsParam={\"VideoArray\":[{\"MediaId\":\"******05512043f49f697f7425******\"},{\"MediaId\":\"******05512043f49f697f7425******\"},{\"MediaId\":\"******05512043f49f697f7425******\"}]}
&<共通パラメーター>

Sys_Template オブジェクトにパラメーターが 1 つだけ含まれている場合は、配列内の要素のパラメーター値のみを指定することで、パラメーター入力を簡略化できます。対応するパラメーター名を指定する必要はありません。生成される Timeline オブジェクトは、上記のサンプル Timeline オブジェクトと同じです。
```
http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_VideoMute
&ClipsParam={\"VideoArray\":[\"b3f37e05512043f49f697f7425b9188b\",\"9987d22788e810116a45109f2ea88648\",\"a8f5f167f44f4964e6c998dee827110c\"]}
&<共通パラメーター>
```

イントロビデオとアウトロビデオを追加する

設定

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // マージされるイントロビデオの ID
                },
                {
                    "Sys_Type" : "ArrayItems", // 配列要素を示します。
                    "Sys_ArrayObject" : "$VideoArray", // 配列オブジェクトを示します。
                    "Sys_Template" : { // 配列要素のテンプレートを示します。
                        "MediaId" : "$MediaId" // ビデオ素材の ID
                    }
                },
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // マージされるアウトロビデオの ID
                }
            ]
        }
    ]
}

タイムライン

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // マージされるイントロビデオの ID
                },
                {
                    "MediaId": "******05512043f49f697f7425******" // ビデオ素材の ID
                },
                {
                    "MediaId": "******2788e810116a45109f2e******" // ビデオ素材の ID
                },
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // ビデオ素材の ID
                },
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // マージされるアウトロビデオの ID
                }
            ]
        }
    ]
}

説明:

通常テンプレートは、ビデオトラックの先頭と末尾に固定のイントロビデオとアウトロビデオを挿入します。イントロビデオとアウトロビデオの間には、配列パラメーターを使用して可変数の素材を指定する必要があります。編集および制作タスクを送信する場合は、TemplateId パラメーターを IceSys_OpeningEnding に設定し、VideoArray を ClipsParam パラメーターの設定に追加します。

http://ice.cn-shanghai.aliyuncs.com/?Action=SubmitMediaProducingJob
&TemplateID=IceSys_OpeningEnding
&ClipsParam={\"VideoArray\":[\"******05512043f49f697f7425******\",\"******2788e810116a45109f2e******\",\"******67f44f4964e6c998dee8******\"]}
&<共通パラメーター>

Timeline オブジェクトを生成するために、IMS は VideoArray パラメーターをトラバースし、Sys_Template オブジェクトを使用して要素を生成し、要素を新しい配列にカプセル化します。ただし、VideoTrackClips 内のイントロビデオとアウトロビデオの間の中間項目はクリップ配列として処理されるため、暫定的に生成された Timeline オブジェクトの形式は無効です。サンプルコード：

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "******2788e810116a45109f2e******" // マージされるイントロビデオの ID
                },
                [
                    {
                        "MediaId": "******05512043f49f697f7425******" // ビデオ素材の ID
                    },
                    {
                        "MediaId": "******2788e810116a45109f2e******" // ビデオ素材の ID
                    },
                    {
                        "MediaId": "******67f44f4964e6c998dee8******" // ビデオ素材の ID
                    }
                ],
                {
                    "MediaId": "******67f44f4964e6c998dee8******" // マージされるアウトロビデオの ID
                }
            ]
        }
    ]
}

この場合、IMS は自動フォールトトレランスを実行します。具体的には、IMS は現在のコンテキストに基づいて配列内の要素を抽出し、配列を 1 次元配列に変換します。最終的に生成される Timeline オブジェクトの詳細については、上記のサンプル Timeline オブジェクトをご参照ください。