タイムラインを使用した画像と動画の編集およびミキシング - Intelligent Media Services

SubmitMediaProducingJob API でタイムラインパラメータを設定することで、画像と動画の編集やミキシングができます。

使用上の注意

インテリジェントプロダクションは、ライブストリーム、VOD ファイル、および Object Storage Service (OSS) の素材ファイルの編集と合成、エフェクトレンダリング、およびテンプレートをサポートしています。詳細については、「インテリジェントプロダクションの概要」をご参照ください。
タイムラインパラメーターを構成し、SubmitMediaProducingJob 操作を呼び出すことで、1 つ以上のビデオ、オーディオファイル、画像、および字幕素材からビデオを生成できます。
タイムラインは、素材を追加し、エフェクトを構成してビデオを作成するときに作成されます。タイムラインは、トラック、素材、およびエフェクトで構成されます。詳細については、「タイムラインの構成」をご参照ください。
IMS SDK を使用してオーディオファイルとビデオファイルを編集する方法の詳細については、「準備」をご参照ください。

出力解像度の設定

SubmitMediaProducingJob API を呼び出して、動画編集ジョブを送信します。OutputMediaConfig の Width と Height を設定して、出力解像度を指定します。

String outputMediaUrl = "https://your-bucket.oss-cn-shanghai.aliyuncs.com/target_video.mp4";
String outputMediaConfig = "{\"MediaURL\":\"" + outputMediaUrl + "\",\"Width\":720,\"Height\":1280}";
SubmitMediaProducingJobRequest request = new SubmitMediaProducingJobRequest();
request.setTimeline("<your-timeline>");
request.setOutputMediaConfig(outputMediaConfig);
SubmitMediaProducingJobResponse response = iceClient.submitMediaProducingJob(request);

横向き動画の縦向き変換と黒帯の追加

横向きの動画を縦向きで出力する場合、システムは素材を比率を保ったままスケーリングし、フレームの中央に配置します。

最終的な効果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4"
    },{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4"
    },{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4"
    }]
  }]
}

横向き動画の縦向き変換とぼかしエリアの追加

Radius (ぼかしの半径) には 0.01 から 1 までの値を指定できます。詳細については、「エフェクトタイプ: 背景設定」をご参照ください。

最終効果

タイムラインの例

{
	"VideoTracks": [{
		"VideoTrackClips": [{
			"MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
			"Effects": [{
				"Type": "Background",
				"SubType": "Blur",
				"Radius": 0.1
			}]
		}, {
			"MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
			"Effects": [{
				"Type": "Background",
				"SubType": "Blur",
				"Radius": 0.1
			}]
		}, {
			"MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
			"Effects": [{
				"Type": "Background",
				"SubType": "Blur",
				"Radius": 0.1
			}]
		}]
	}]
}

3 画面分割エフェクトを使った横長動画の縦長変換

AdaptMode=Cover は、アスペクト比を維持したまま素材をスケーリングしてターゲットエリアを埋めます。その他の値については、「VideoTrackClip」をご参照ください。

最終的な効果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.3333,
      "AdaptMode": "Cover"
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.3333,
      "AdaptMode": "Cover"
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.3333,
      "AdaptMode": "Cover"
    }]
  },{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0,
      "AdaptMode": "Cover"
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0,
      "AdaptMode": "Cover"
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0,
      "AdaptMode": "Cover"
    }]
  },{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.6666,
      "AdaptMode": "Cover"
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.6666,
      "AdaptMode": "Cover"
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.6666,
      "AdaptMode": "Cover"
    }]
  }],
  "SubtitleTracks":[
    {
      "SubtitleTrackClips": [
        {
          "Type": "Text",
          "X": 0,
          "Y": 200,
          "Font": "AlibabaPuHuiTi",
          "Content": "これはタイトルです",
          "Alignment": "TopCenter",
          "FontSize": 80,
          "FontColorOpacity": 1,
          "1FontColor": "#ffffff",
          "FontColor": "#FFDEAD",
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        }
      ]
    },
    {
      "SubtitleTrackClips": [
        {
          "Type":"Text",
          "X": 0,
          "Y": 320,
          "Font": "KaiTi",
          "Content": "これは字幕です",
          "Alignment": "TopCenter",
          "FontSize": 45,
          "FontColor": "#ffffff",
          "FontFace": {
            "Bold": false,
            "Italic": true,
            "Underline": true
          }
        }
      ]
    },
    {
      "SubtitleTrackClips":[
        {
          "Type":"Text",
          "X": 0,
          "Y": 900,
          "Font": "AlibabaPuHuiTi",
          "Content": "動画結合中にキャプションを追加できます。\n改行を使用すると、テキストを複数行に表示できます。",
          "Alignment": "TopCenter",
          "FontSize": 40,
          "FontColor": "#ffffff",
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        }
      ]
    }
  ]
}

横長動画の縦長への変換と背景色の設定

最終的な効果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "Effects": [{
        "Type": "Background",
        "SubType": "Color",
        "Color": "#000066"
      }]
    }, {
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Effects": [{
        "Type": "Background",
        "SubType": "Color",
        "Color": "#006400"
      }]
    }, {
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
      "Effects": [{
        "Type": "Background",
        "SubType": "Color",
        "Color": "#8B1A1A"
      }]
    }]
  }]
}

動画のトリミング

In=3 と Out=8 は、3秒から8秒のセグメントをトリミングして抽出します。

効果	タイムラインの例
	`{ "VideoTracks": [{ "VideoTrackClips": [{ "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4", "In": 3, "Out": 8 }] }] }`

複数ビデオセグメントのトリミングと結合

TimelineIn と TimelineOut を省略すると、システムは素材を順番に連結します。

MaxOut を 5 に設定すると、素材を最大 5 秒まで使用します：

素材が 5 秒より長い場合：先頭の 5 秒を使用します。
素材が 5 秒より短い場合：素材全体を使用します。

出力結果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "In": 3,
      "Out": 8
    }, {
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "MaxOut": 5
    }, {
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
      "Effects": [{
        "Type": "Clip",
        "SubType": "RandomClip",
        "ClipDuration": 5
      }]
    }]
  }]
}

動画と画像のミキシング

Type のデフォルト値は Video です。画像素材を使用する場合は、Type を Image に設定します。

最終効果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "Out": 3
    }, {
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/image/01.jpg",
      "Type": "Image",
      "Duration": 3
    }, {
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Out": 3
    }, {
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/image/02.jpg",
      "Type": "Image",
      "Duration": 3
    }, {
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
      "Out": 3
    }]
  }]
}

ウォーターマーク、ステッカー、またはGIFステッカーの追加

GIF 画像の場合は、DyncFrames を GIF のフレーム数に設定します。

最終効果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "Out": 5
    }, {
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Out": 5
    }, {
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
      "Out": 5
    }]
  },{
    "VideoTrackClips": [{
      "Type": "Image",
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/image/s1.png",
      "TimelineIn": 0,
      "Duration": 5,
      "X": 40,
      "Y": 40,
      "Width": 300,
      "Height": 150
    }, {
      "Type": "Image",
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/image/g2.gif",
      "TimelineIn": 5,
      "Duration": 5,
      "X": 20,
      "Y": 800,
      "Width": 200,
      "Height": 200,
      "DyncFrames": 8
    }, {
      "Type": "Image",
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/image/g1.gif",
      "TimelineIn": 10,
      "Duration": 5,
      "X": 400,
      "Y": 40,
      "Width": 200,
      "Height": 200,
      "DyncFrames": 8
    }]
  }]
}

スケールモード

AdaptMode には Contain、Cover、Fill を指定できます。詳細については、「VideoTrackClip」をご参照ください。

最終的な効果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.3333,
      "AdaptMode": "Cover",
      "Out": 5
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.3333,
      "AdaptMode": "Cover",
      "Out": 5
    }]
  },{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0,
      "AdaptMode": "Contain",
      "Out": 5
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0,
      "AdaptMode": "Contain",
      "Out": 5
    }]
  },{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.6666,
      "AdaptMode": "Fill",
      "Out": 5
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.6666,
      "AdaptMode": "Fill",
      "Out": 5
    }]
  }],
  "SubtitleTracks":[
    {
      "SubtitleTrackClips":[
        {
          "Type":"Text",
          "X": 0,
          "Y": 0.3333,
          "Font": "AlibabaPuHuiTi",
          "Content": "AdaptMode=Cover：アスペクト比を維持したまま、ターゲットエリア全体を埋めるようにコンテンツをスケーリングします。オブジェクトのアスペクト比がコンテンツボックスと一致しない場合、フィットするようにオブジェクトをクロップします。",
          "FontSize": 30,
          "FontColor": "#ffffff",
          "AdaptMode": "AutoWrap",
          "TextWidth": 1,
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        }
      ]
    },
    {
      "SubtitleTrackClips":[
        {
          "Type":"Text",
          "X": 0,
          "Y": 0,
          "Font": "AlibabaPuHuiTi",
          "Content": "AdaptMode=Contain：アスペクト比を維持したまま、ターゲットエリア内に収まるようにコンテンツをスケーリングします。",
          "FontSize": 30,
          "FontColor": "#ffffff",
          "AdaptMode": "AutoWrap",
          "TextWidth": 1,
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        }
      ]
    },
    {
      "SubtitleTrackClips":[
        {
          "Type":"Text",
          "X": 0,
          "Y": 0.6666,
          "Font": "AlibabaPuHuiTi",
          "Content": "AdaptMode=Fill：これはデフォルトの動作です。ターゲットのコンテンツボックスを正確に埋めるようにコンテンツのサイズを調整します。オブジェクト全体がボックスを完全に埋めます。オブジェクトのアスペクト比がコンテンツボックスと一致しない場合、フィットするようにオブジェクトを引き伸ばします。",
          "FontSize": 30,
          "FontColor": "#ffffff",
          "AdaptMode": "AutoWrap",
          "TextWidth": 1,
          "FontFace": {
            "Bold": true,
            "Italic": false,
            "Underline": false
          }
        }
      ]
    }
  ]
}

ピクチャーインピクチャー

VideoTracks では、後にあるトラックほどレイヤーレベルが高く、先にあるトラックの上にオーバーレイします。

最終効果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4"
    }]
  },{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
      "X": 0.25,
      "Y": 0.25,
      "Width": 0.5,
      "Height": 0.5
    }]
  }]
}

水平反転と垂直反転

最終効果

タイムラインの例

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
          "Width": 0.5,
          "Height": 0.5,
          "X": 0,
          "Y": 0,
          "Effects": [
            {
              "Type": "Text",
              "FixedX": 0,
              "FixedY": 0,
              "Font": "HappyZcool-2016",
              "Content": "元の動画",
              "Alignment": "TopLeft",
              "FontSize": 80,
              "FontColor": "#F5FFFA",
              "TimelineIn": 0,
              "TimelineOut": 10,
              "Outline": 1,
              "OutlineColour": "#0e0100"
            }
          ]
        }
      ]
    },
    {
      "VideoTrackClips": [
        {
          "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
          "Width": 0.5,
          "Height": 0.5,
          "X": 0.5,
          "Y": 0,
          "Effects": [
            {
              "Type": "Flip",
              "Direction": "horizontal"
            },{
              "Type": "Text",
              "FixedX": 0.5,
              "FixedY": 0,
              "Font": "HappyZcool-2016",
              "Content": "水平反転",
              "Alignment": "TopLeft",
              "FontSize": 80,
              "FontColor": "#F5FFFA",
              "TimelineIn": 0,
              "TimelineOut": 10,
              "Outline": 1,
              "OutlineColour": "#0e0100"
            }
          ]
        }
      ]
    },
    {
      "VideoTrackClips": [
        {
          "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
          "Width": 0.5,
          "Height": 0.5,
          "X": 0,
          "Y": 0.5,
          "Effects": [
            {
              "Type": "Flip",
              "Direction": "vertical"
            },{
              "Type": "Text",
              "FixedX": 0,
              "FixedY": 0.5,
              "Font": "HappyZcool-2016",
              "Content": "垂直反転",
              "Alignment": "TopLeft",
              "FontSize": 80,
              "FontColor": "#F5FFFA",
              "TimelineIn": 0,
              "TimelineOut": 10,
              "Outline": 1,
              "OutlineColour": "#0e0100"
            }
          ]
        }
      ]
    },
    {
      "VideoTrackClips": [
        {
          "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
          "Width": 0.5,
          "Height": 0.5,
          "X": 0.5,
          "Y": 0.5,
          "Effects": [
            {
              "Type": "Flip",
              "Direction": "horizontal"
            },{
              "Type": "Flip",
              "Direction": "vertical"
            },{
              "Type": "Text",
              "FixedX": 0.5,
              "FixedY": 0.5,
              "Font": "HappyZcool-2016",
              "Content": "水平・垂直反転",
              "Alignment": "TopLeft",
              "FontSize": 80,
              "FontColor": "#F5FFFA",
              "TimelineIn": 0,
              "TimelineOut": 10,
              "Outline": 1,
              "OutlineColour": "#0e0100"
            }
          ]
        }
      ]
    }
  ]
}

動画のクロップ

最終エフェクト

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
      "Out": 3,
      "X": 0.3,
      "Y": 0.3,
      "Width":0.4,
      "Height":0.4,
      "Effects": [{
        "Type":"Crop",
        "X":0.3,
        "Y":0.3,
        "Width":0.4,
        "Height":0.4
      },{
        "Type": "Text",
        "Font": "HappyZcool-2016",
        "Content": "Crop by 60%",
        "FixedY": 150,
        "Alignment": "TopCenter",
        "FixedFontSize": 70,
        "FontColor": "#F5FFFA",
        "Outline": 1,
        "OutlineColour": "#0e0100"
      }]
    },{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
      "In": 3,
      "Out": 6,
      "X": 0.15,
      "Y": 0.15,
      "Width":0.7,
      "Height":0.7,
      "Effects": [{
        "Type":"Crop",
        "X":0.15,
        "Y":0.15,
        "Width":0.7,
        "Height":0.7
      },{
        "Type": "Text",
        "Font": "HappyZcool-2016",
        "Content": "Crop by 30%",
        "FixedY": 150,
        "Alignment": "TopCenter",
        "FixedFontSize": 70,
        "FontColor": "#F5FFFA",
        "Outline": 1,
        "OutlineColour": "#0e0100"
      }]
    },{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
      "In": 6,
      "Out": 9,
      "Effects": [{
        "Type": "Text",
        "Font": "HappyZcool-2016",
        "Content": "No crop",
        "FixedY": 150,
        "Alignment": "TopCenter",
        "FixedFontSize": 70,
        "FontColor": "#F5FFFA",
        "Outline": 1,
        "OutlineColour": "#0e0100"
      }]
    }]
  }]
}

オーディオとビデオの速度変更

VideoTrackClips は、再生速度をコントロールするための Speed パラメーターもサポートしています。

最終的な効果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Out": 3,
      "Effects": [{
        "Type": "Text",
        "Font": "HappyZcool-2016",
        "Content": "元の速度",
        "FixedY": 150,
        "Alignment": "TopCenter",
        "FixedFontSize": 70,
        "FontColor": "#F5FFFA"
      }]
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Speed": 2,
      "Out": 6,
      "Effects": [{
        "Type": "Text",
        "Font": "HappyZcool-2016",
        "Content": "2倍速",
        "FixedY": 150,
        "Alignment": "TopCenter",
        "FixedFontSize": 70,
        "FontColor": "#F5FFFA"
      }]
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Speed": 3,
      "Out": 9,
      "Effects": [{
        "Type": "Text",
        "Font": "HappyZcool-2016",
        "Content": "3倍速",
        "FixedY": 150,
        "Alignment": "TopCenter",
        "FixedFontSize": 70,
        "FontColor": "#F5FFFA"
      }]
    }]
  }]
}

素材の回転

最終的な効果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Out": 3,
      "Effects": [{
        "Type": "Text",
        "Font": "HappyZcool-2016",
        "Content": "Original angle",
        "FixedY": 150,
        "Alignment": "TopCenter",
        "FixedFontSize": 70,
        "FontColor": "#F5FFFA",
        "Outline": 1,
        "OutlineColour": "#0e0100"
      }]
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Out": 3,
      "X": 0,
      "Y": 0,
      "Height": 1280,
      "Width": 720,
      "Effects": [{
        "Type": "Rotate",
        "Degree": 90
      },{
        "Type": "Text",
        "Font": "HappyZcool-2016",
        "Content": "Rotate 90 degrees",
        "FixedY": 150,
        "Alignment": "TopCenter",
        "FixedFontSize": 70,
        "FontColor": "#F5FFFA",
        "Outline": 1,
        "OutlineColour": "#0e0100"
      }]
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Out": 3,
      "Effects": [{
        "Type": "Rotate",
        "Degree": 180
      },{
        "Type": "Text",
        "Font": "HappyZcool-2016",
        "Content": "Rotate 180 degrees",
        "FixedY": 150,
        "Alignment": "TopCenter",
        "FixedFontSize": 70,
        "FontColor": "#F5FFFA",
        "Outline": 1,
        "OutlineColour": "#0e0100"
      }]
    },{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Out": 3,
      "X": 0,
      "Y": 0,
      "Height": 1280,
      "Width": 720,
      "Effects": [{
        "Type": "Rotate",
        "Degree": 270
      },{
        "Type": "Text",
        "Font": "HappyZcool-2016",
        "Content": "Rotate 270 degrees",
        "FixedY": 150,
        "Alignment": "TopCenter",
        "FixedFontSize": 70,
        "FontColor": "#F5FFFA",
        "Outline": 1,
        "OutlineColour": "#0e0100"
      }]
    }]
  }]
}

円形、矩形、線形、ミラーマスク

最終効果

タイムラインの例

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaUrl": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
                    "Width": 1,
                    "Height": 1,
                    "In": 0,
                    "Out": 5,
                    "AdaptMode": "Cover",
                    "Duration": 10
                }
            ]
        },
        {
            "VideoTrackClips": [
                {
                    "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
                    "X": 0.1,
                    "Y": 0.1,
                    "Width": 0.3,
                    "Height": 0.3,
                    "AdaptMode": "Cover",
                    "In": 0,
                    "Out": 5,
                    "Effects": [
                        {
                            "Type": "VFX",
                            "SubType": "mask_circle",
                            "ExtParams": "x=0.5,y=0.2,width=200.0,height=200.0,antialias=0.05"
                        }
                    ]
                }
            ]
        },
        {
            "VideoTrackClips": [
                {
                    "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
                    "X": 0.5,
                    "Y": 0.1,
                    "Width": 0.3,
                    "Height": 0.3,
                    "AdaptMode": "Cover",
                    "In": 0,
                    "Out": 5,
                    "Effects": [
                        {
                            "Type": "VFX",
                            "SubType": "mask_linear",
                            "ExtParams": "x=0.5,y=0.2,antialias=0.1,angle=90.0"
                        }
                    ]
                }
            ]
        },
        {
            "VideoTrackClips": [
                {
                    "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
                    "X": 0.1,
                    "Y": 0.5,
                    "Width": 0.3,
                    "Height": 0.3,
                    "AdaptMode": "Cover",
                    "In": 0,
                    "Out": 5,
                    "Effects": [
                        {
                            "Type": "VFX",
                            "SubType": "mask_minor",
                            "ExtParams": "x=0.5,y=0.4,size=0.6,angle=45.0"
                        }
                    ]
                }
            ]
        },
        {
            "VideoTrackClips": [
                {
                    "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/v1.mp4",
                    "X": 0.5,
                    "Y": 0.5,
                    "Width": 0.3,
                    "Height": 0.3,
                    "AdaptMode": "Cover",
                    "In": 0,
                    "Out": 5,
                    "Effects": [
                        {
                            "Type": "VFX",
                            "SubType": "mask_rec",
                            "ExtParams": "x=0.5,y=200.0,width=200.0,height=200.0,radius=50.0,antialias=0.03"
                        }
                    ]
                }
            ]
        }
    ]
}

マスク部分ぼかしの最終効果

タイムラインの例

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "X": 0,
          "Y": 0,
          "In": 0,
          "Out": 5,
          "Width": 0.5,
          "Height": 0.5,
          "Effects": [
            {
              "Type": "VFX",
              "SubType": "mask_circle",
              "ExtParams": "x=0.5,y=0.5,width=0.6,height=0.6,antialias=0.01,angle=0.0,blur_intensity=1.0,outer_alpha=1.0"
            }
          ],
          "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
          "AdaptMode": "Cover"
        }
      ]
    },
    {
      "VideoTrackClips": [
        {
          "X": 0.5,
          "Y": 0,
          "In": 0,
          "Out": 5,
          "Width": 0.5,
          "Height": 0.5,
          "Effects": [
            {
              "Type": "VFX",
              "SubType": "mask_linear",
              "ExtParams": "x=0.5,y=0.5,angle=90.0,antialias=0.01,blur_intensity=1.0,outer_alpha=1.0"
            }
          ],
          "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
          "AdaptMode": "Cover"
        }
      ]
    },
    {
      "VideoTrackClips": [
        {
          "X": 0,
          "Y": 0.5,
          "In": 0,
          "Out": 5,
          "Width": 0.5,
          "Height": 0.5,
          "Effects": [
            {
              "Type": "VFX",
              "SubType": "mask_minor",
              "ExtParams": "x=0.5,y=0.4,size=0.6,angle=45.0,antialias=0.01,blur_intensity=1.0,outer_alpha=1.0"
            }
          ],
          "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
          "AdaptMode": "Cover"
        }
      ]
    },
    {
      "VideoTrackClips": [
        {
          "X": 0.5,
          "Y": 0.5,
          "In": 0,
          "Out": 5,
          "Width": 0.5,
          "Height": 0.5,
          "Effects": [
            {
              "Type": "VFX",
              "SubType": "mask_rec",
              "ExtParams": "x=0.5,y=0.5,width=0.6,height=0.6,radius=0.15,antialias=0.01,angle=0.0,blur_intensity=1.0,outer_alpha=1.0"
            }
          ],
          "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
          "AdaptMode": "Cover"
        }
      ]
    }
  ]
}

パラメーターの説明

円形 (楕円)

type = mask_circle

パラメーター	タイプ	有効な値	デフォルト値	説明
x	float	[0.0, 素材の幅]	0.5	素材の左上隅を基準とした、素材内におけるマスク中心の X 座標です。 0.0 ～ 1.0 の値は、素材の幅に対する相対座標を表します。 1.0 を超える値は、絶対ピクセル値を表します。
y	float	[0.0, 素材の高さ]	0.5	素材の左上隅を基準とした、素材内におけるマスク中心の Y 座標です。 0.0 ～ 1.0 の値は、素材の高さに対する相対座標を表します。 1.0 を超える値は、絶対ピクセル値を表します。
width	float	[0.0, 素材の幅]	0.8	楕円マスクの幅です。 0.0 ～ 1.0 の値は、素材の幅に対する相対的な幅を表します。 1.0 を超える値は、絶対ピクセル値を表します。
height	float	[0.0, 素材の高さ]	0.8	楕円マスクの高さです。 0.0 ～ 1.0 の値は、素材の高さに対する相対的な高さを表します。 1.0 を超える値は、絶対ピクセル値を表します。
antialias	float	[0.0, 1.0]	0.1	楕円マスクのアンチエイリアスパラメーターです。値が大きいほど、エッジのぼかしが強くなります。
angle	float	[-9999.0, 9999.0]	0.0	回転角度です。
blur_intensity	float	[0.0, 1.0]	0.0	マスク内のぼかしの強度です。0.0 を指定すると、ぼかしは無効になります。値が大きいほど、マスク内の領域に適用されるぼかしが強くなります。
outer_alpha	float	[0.0, 1.0]	0.0	マスク外の領域の不透明度です。0.0 を指定すると、その領域は完全に透明になり、1.0 を指定すると元の画像が完全に保持されます。中間値を指定すると、その領域は部分的に透明になります。

矩形

type = mask_rec

パラメーター	タイプ	有効な値	デフォルト値	説明
x	float	[0.0, 素材の幅]	0.5	素材の左上隅を基準とした、素材内における矩形マスク中心の X 座標です。 0.0 ～ 1.0 の値は、素材の幅に対する相対座標を表します。 1.0 を超える値は、絶対ピクセル値を表します。
y	float	[0.0, 素材の高さ]	0.5	素材の左上隅を基準とした、素材内における矩形マスク中心の Y 座標です。 0.0 ～ 1.0 の値は、素材の高さに対する相対座標を表します。 1.0 を超える値は、絶対ピクセル値を表します。
width	float	[0.0, 素材の幅]	0.8	矩形マスクの幅です。 0.0 ～ 1.0 の値は、素材の幅に対する相対的な幅を表します。 1.0 を超える値は、絶対ピクセル値を表します。
height	float	[0.0, 素材の高さ]	0.8	矩形マスクの高さです。 0.0 ～ 1.0 の値は、素材の高さに対する相対的な高さを表します。 1.0 を超える値は、絶対ピクセル値を表します。
antialias	float	[0.0, 1.0]	0.1	矩形マスクのアンチエイリアスパラメーターです。値が大きいほど、エッジのぼかしが強くなります。
radius	float	[0.0, 素材の幅または高さのうち大きい方]	0.1	矩形マスクの角の半径です。 0.0 ～ 1.0 の値は、素材の幅または高さのうち大きい方に対する相対的な半径サイズを表します。 1.0 を超える値は、絶対ピクセル値を表します。
angle	float	[-9999.0, 9999.0]	0.0	回転角度です。
blur_intensity	float	[0.0, 1.0]	0.0	マスク内のぼかしの強度です。0.0 を指定すると、ぼかしは無効になります。値が大きいほど、マスク内の領域に適用されるぼかしが強くなります。
outer_alpha	float	[0.0, 1.0]	0.0	マスク外の領域の不透明度です。0.0 を指定すると、その領域は完全に透明になり、1.0 を指定すると元の画像が完全に保持されます。中間値を指定すると、その領域は部分的に透明になります。

線形

type = mask_linear

パラメーター	タイプ	有効な値	デフォルト値	説明
x	float	[0.0, 素材の幅]	0.5	素材の左上隅を基準とした、素材内における線形マスクの中心の基準点の X 座標です。 0.0 ～ 1.0 の値は、素材の幅に対する相対座標を表します。 1.0 を超える値は、絶対ピクセル値を表します。
y	float	[0.0, 素材の高さ]	0.5	素材の左上隅を基準とした、素材内における線形マスクの中心の基準点の Y 座標です。 0.0 ～ 1.0 の値は、素材の高さに対する相対座標を表します。 1.0 を超える値は、絶対ピクセル値を表します。
antialias	float	[0.0, 1.0]	0.1	線形マスクのアンチエイリアスパラメーターです。値が大きいほど、エッジのぼかしが強くなります。
angle	float	[-9999.0, 9999.0]	0.0	回転角度です。
blur_intensity	float	[0.0, 1.0]	0.0	マスク内のぼかしの強度です。0.0 を指定すると、ぼかしは無効になります。値が大きいほど、マスク内の領域に適用されるぼかしが強くなります。
outer_alpha	float	[0.0, 1.0]	0.0	マスク外の領域の不透明度です。0.0 を指定すると、その領域は完全に透明になり、1.0 を指定すると元の画像が完全に保持されます。中間値を指定すると、その領域は部分的に透明になります。

ミラーマスク

type = mask_minor

パラメーター	タイプ	有効な値	デフォルト値	説明
x	float	[0.0, 素材の幅]	0.5	素材の左上隅を基準とした、素材内におけるミラーマスクの中心の基準点の X 座標です。 0.0 ～ 1.0 の値は、素材の幅に対する相対座標を表します。 1.0 を超える値は、絶対ピクセル値を表します。
y	float	[0.0, 素材の高さ]	0.5	素材の左上隅を基準とした、素材内におけるミラーマスクの中心の基準点の Y 座標です。 0.0 ～ 1.0 の値は、素材の高さに対する相対座標を表します。 1.0 を超える値は、絶対ピクセル値を表します。
antialias	float	[0.0, 1.0]	0.1	ミラーマスクのアンチエイリアスパラメーターです。値が大きいほど、エッジのぼかしが強くなります。
angle	float	[-9999.0, 9999.0]	0.0	回転角度です。
blur_intensity	float	[0.0, 1.0]	0.0	マスク内のぼかしの強度です。0.0 を指定すると、ぼかしは無効になります。値が大きいほど、マスク内の領域に適用されるぼかしが強くなります。
outer_alpha	float	[0.0, 1.0]	0.0	マスク外の領域の不透明度です。0.0 を指定すると、その領域は完全に透明になり、1.0 を指定すると元の画像が完全に保持されます。中間値を指定すると、その領域は部分的に透明になります。

ビデオフリーズフレーム

ビデオを 0～3 秒でトリミングし、2 秒間のフリーズフレームを追加します。

最終効果

タイムラインの例

{
  "VideoTracks": [{
    "VideoTrackClips": [{
      "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "In": 0,
      "Out": 3,
      "Effects": [{
        "Type": "FreezeFrame",
        "Duration": 2
      }]
    }]
  }],
  "SubtitleTracks": [{
    "SubtitleTrackClips": [{
      "Type": "Text",
      "TimelineIn": 0,
      "TimelineOut": 3,
      "X": 0,
      "Y": 150,
      "Font": "HappyZcool-2016",
      "Content": "素材を 0～3 秒トリミング",
      "Alignment": "TopCenter",
      "FontSize": 80,
      "FontColor": "#F5FFFA",
      "FontFace": {
        "Bold": true
      }
    }, {
      "Type": "Text",
      "TimelineIn": 3,
      "TimelineOut": 5,
      "X": 0,
      "Y": 150,
      "Font": "HappyZcool-2016",
      "Content": "フリーズフレーム 2 秒",
      "Alignment": "TopCenter",
      "FontSize": 80,
      "FontColor": "#F5FFFA",
      "FontFace": {
        "Bold": true
      }
    }]
  }]
}

Intelligent Media Services:画像と動画の編集

使用上の注意

出力解像度の設定

横向き動画の縦向き変換と黒帯の追加

横向き動画の縦向き変換とぼかしエリアの追加

3 画面分割エフェクトを使った横長動画の縦長変換

横長動画の縦長への変換と背景色の設定

動画のトリミング

複数ビデオセグメントのトリミングと結合

動画と画像のミキシング

ウォーターマーク、ステッカー、またはGIFステッカーの追加

スケールモード

ピクチャーインピクチャー

水平反転と垂直反転

動画のクロップ

オーディオとビデオの速度変更

素材の回転

円形、矩形、線形、ミラーマスク

パラメーターの説明

ビデオフリーズフレーム

リファレンス

使用上の注意

出力解像度の設定

横向き動画の縦向き変換と黒帯の追加

横向き動画の縦向き変換とぼかしエリアの追加

3 画面分割エフェクトを使った横長動画の縦長変換

横長動画の縦長への変換と背景色の設定

動画のトリミング

複数ビデオセグメントのトリミングと結合

動画と画像のミキシング

ウォーターマーク、ステッカー、またはGIFステッカーの追加

スケールモード

ピクチャーインピクチャー

水平反転と垂直反転

動画のクロップ

オーディオとビデオの速度変更

素材の回転

円形、矩形、線形、ミラーマスク

パラメーターの説明

ビデオ フリーズフレーム

リファレンス

ビデオフリーズフレーム