すべてのプロダクト
Search
ドキュメントセンター

Intelligent Media Services:画像とビデオの編集

最終更新日:Mar 14, 2025

このトピックでは、タイムライン パラメーターを SubmitMediaProducingJob オペレーションで設定して画像とビデオを編集する方法について説明します。

使用方法

  • インテリジェントプロダクションは、ライブストリーム、VOD ファイル、およびオブジェクトストレージサービス (OSS) のマテリアルファイルの編集と合成、エフェクトレンダリング、テンプレートをサポートしています。 詳細については、「インテリジェントプロダクションの概要」をご参照ください。

  • 1 つ以上のビデオ、オーディオファイル、画像、字幕素材から タイムラインパラメーター を設定し、SubmitMediaProducingJob オペレーションを呼び出すことで、ビデオを生成できます。

  • タイムラインは、素材を追加し、エフェクトを設定してビデオを作成するときに作成されます。 タイムラインは、トラック、素材、エフェクトで構成されます。 詳細については、「タイムラインの設定」をご参照ください。

  • IMS SDK を使用してオーディオファイルとビデオファイルを編集する方法の詳細については、「準備」をご参照ください。

ビデオの幅と高さの設定

SubmitMediaProducingJob オペレーションを呼び出してビデオ編集タスクを送信する場合、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-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.3333,
      "AdaptMode": "Cover" // カバー
    },{
      "MediaURL": "http://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
      "Width": 1,
      "Height": 0.3333,
      "X": 0,
      "Y": 0.3333,
      "AdaptMode": "Cover" // カバー
    },{
      "MediaURL": "http://ice-document-materials.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", // 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", // KaiTi フォント
          "Content": "小見出し", // 小見出し
          "Alignment": "TopCenter", // 上中央揃え
          "FontSize": 45,
          "FontColor": "#ffffff",
          "FontFace": {
            "Bold": false, // 太字
            "Italic": true, // イタリック体
            "Underline": true // 下線
          }
        }
      ]
    },
    {
      "SubtitleTrackClips":[ // 字幕トラッククリップ
        {
          "Type":"Text", // テキスト
          "X": 0,
          "Y": 900,
          "Font": "AlibabaPuHuiTi", // AlibabaPuHuiTi フォント
          "Content": "編集中に字幕を追加できます\n複数行表示の場合は改行を追加できます", // 編集中に字幕を追加できます\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 形式の画像を編集するには、GIF 素材のフレームレートを指定する DyncFrames パラメーターを設定する必要があります。

エフェクト

タイムラインの例

{
  "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,
          "Font": "AlibabaPuHuiTi", // AlibabaPuHuiTi フォント
          "Content": "AdaptMode=Cover: 元の縦横比に基づいて素材のサイズを変更してビューに合わせます。 オブジェクトの縦横比がビューと一致しない場合、オブジェクトはフレームの幅と高さに基づいてトリミングされます。", // AdaptMode=Cover: 元の縦横比に基づいて素材のサイズを変更してビューに合わせます。 オブジェクトの縦横比がビューと一致しない場合、オブジェクトはフレームの幅と高さに基づいてトリミングされます。
          "FontSize": 30,
          "FontColor": "#ffffff",
          "AdaptMode": "AutoWrap", // 自動改行
          "TextWidth": 1,
          "FontFace": {
            "Bold": true, // 太字
            "Italic": false, // イタリック体
            "Underline": false // 下線
          }
        }
      ]
    },
    {
      "SubtitleTrackClips":[ // 字幕トラッククリップ
        {
          "Type":"Text", // テキスト
          "X": 0,
          "Y": 0.3333,
          "Font": "AlibabaPuHuiTi", // AlibabaPuHuiTi フォント
          "Content": "AdaptMode=Contain: 素材の元の縦横比に基づいて素材のサイズを変更してビューに合わせます。", // 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", // AlibabaPuHuiTi フォント
          "Content": "AdaptMode=Fill (デフォルト): 元の縦横比に基づいて素材のサイズを変更し、素材をストレッチしてビューに合わせます。", // 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, // 固定 X
              "FixedY": 0, // 固定 Y
              "Font": "HappyZcool-2016", // 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, // 固定 X
              "FixedY": 0, // 固定 Y
              "Font": "HappyZcool-2016", // 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, // 固定 X
              "FixedY": 0.5, // 固定 Y
              "Font": "HappyZcool-2016", // 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, // 固定 X
              "FixedY": 0.5, // 固定 Y
              "Font": "HappyZcool-2016", // 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", // HappyZcool-2016 フォント
        "Content": "ビデオを 60% トリミングします。", // ビデオを 60% トリミングします。
        "FixedY": 150, // 固定 Y
        "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", // HappyZcool-2016 フォント
        "Content": "ビデオを 30% トリミングします。", // ビデオを 30% トリミングします。
        "FixedY": 150, // 固定 Y
        "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", // HappyZcool-2016 フォント
        "Content": "トリミングなし", // トリミングなし
        "FixedY": 150, // 固定 Y
        "Alignment": "TopCenter", // 上中央揃え
        "FixedFontSize": 70, // 固定フォントサイズ
        "FontColor": "#F5FFFA",
        "Outline": 1, // アウトライン
        "OutlineColour": "#0e0100" // アウトラインの色
      }]
    }]
  }]
}

スピードランプの設定

AudioTrackClips では、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", // HappyZcool-2016 フォント
        "Content": "元の速度", // 元の速度
        "FixedY": 150, // 固定 Y
        "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", // HappyZcool-2016 フォント
        "Content": "2倍速", // 2倍速
        "FixedY": 150, // 固定 Y
        "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", // HappyZcool-2016 フォント
        "Content": "3倍速", // 3倍速
        "FixedY": 150, // 固定 Y
        "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", // HappyZcool-2016 フォント
        "Content": "元の角度", // 元の角度
        "FixedY": 150, // 固定 Y
        "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": 720,
      "Width": 1280,
      "Effects": [{ // エフェクト
        "Type": "Rotate", // 回転
        "Degree": 90 // 度
      },{
        "Type": "Text", // テキスト
        "Font": "HappyZcool-2016", // HappyZcool-2016 フォント
        "Content": "90° 回転します。", // 90° 回転します。
        "FixedY": 150, // 固定 Y
        "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", // HappyZcool-2016 フォント
        "Content": "180° 回転", // 180° 回転
        "FixedY": 150, // 固定 Y
        "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": 720,
      "Width": 1280,
      "Effects": [{ // エフェクト
        "Type": "Rotate", // 回転
        "Degree": 270 // 度
      },{
        "Type": "Text", // テキスト
        "Font": "HappyZcool-2016", // HappyZcool-2016 フォント
        "Content": "270° 回転します", // 270° 回転します
        "FixedY": 150, // 固定 Y
        "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", // 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", // 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", // 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", // VFX
                            "SubType": "mask_rec", // 四角形マスク
                            "ExtParams": "x=0.5,y=200.0,width=200.0,height=200.0,radius=50.0,antialias=0.03" // 拡張パラメーター
                        }
                    ]
                }
            ]
        }
    ]
}

パラメーターの説明

  • 円 (楕円)

    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

    回転角度。

  • 四角形

    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

    回転角度。

  • 線形

    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

    回転角度。

  • ミラー

    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

    回転角度。

関連情報