このトピックでは、タイムライン パラメーターを 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);ビデオを横長モードから縦長モードに回転し、黒いバーを追加する
タイムラインのビデオが横長モードで、編集タスクを送信するときに縦長モードに出力ビデオを設定すると、システムはビデオのサイズを新しい寸法に合わせて調整し、フレーム内で中央に配置します。
エフェクト | タイムラインの例 |
|
ビデオを横長モードから縦長モードに回転し、空白領域をぼかす
Radius の値の範囲: [0.01, 1]。 詳細については、「エフェクトタイプ: 背景」をご参照ください。
エフェクト | タイムラインの例 |
|
横長ビデオを縦長モードの3分割画面ビデオに変換する
AdaptMode=Cover パラメーターは、元の縦横比に従って素材のサイズが変更され、ビューに収まることを示します。 その他のパラメーターについては、「VideoTrackClip」をご参照ください。
エフェクト | タイムラインの例 |
|
ビデオを横長モードから縦長モードに回転し、背景色を設定する
エフェクト | タイムラインの例 |
|
ビデオクリップを抽出する
In=3 および Out=8 を設定することにより、ビデオの3秒目から8秒目までのクリップを抽出できます。
エフェクト | タイムラインの例 |
|
複数のビデオクリップを抽出してマージする
TimelineIn フィールドと TimelineOut フィールドは空のままにできます。 デフォルトでは、システムはデフォルトの開始時刻と終了時刻を使用してクリップをマージします。
MaxOut が 5 に設定されている場合、クリップから最大 5 秒が抽出されます。
クリップの継続時間が 5 秒を超える場合は、最初の 5 秒のみが抽出されます。
クリップの継続時間が 5 秒未満の場合は、クリップの最後まで抽出されます。
エフェクト | タイムラインの例 |
|
画像とビデオを編集する
Type のデフォルト値は Video です。 画像を編集する場合は、Type を Image に設定します。
エフェクト | タイムラインの例 |
|
ウォーターマーク、ステッカー、または GIF ステッカーを追加する
GIF 形式の画像を編集するには、GIF 素材のフレームレートを指定する DyncFrames パラメーターを設定する必要があります。
エフェクト | タイムラインの例 |
|
スケーリングの設定
AdaptMode の有効な値は、Contain、Cover、および Fill です。 詳細については、「VideoTrackClip」をご参照ください。
エフェクト | タイムラインの例 |
|
ピクチャインピクチャの設定
VideoTracks では、配列内のトラックの順序が重要であり、最後のトラックが前のトラックの上にレンダリングされます。
エフェクト | タイムラインの例 |
|
水平方向または垂直方向の反転の設定
エフェクト | タイムラインの例 |
|
ビデオのトリミング
エフェクト | タイムラインの例 |
|
スピードランプの設定
AudioTrackClips では、Speed パラメーターを使用してオーディオとビデオのスピードランプを設定できます。
エフェクト | タイムラインの例 |
|
素材の回転
エフェクト | タイムラインの例 |
|
円、四角形、線形、およびミラーマスクを作成する
エフェクト | タイムラインの例 |
|
パラメーターの説明
円 (楕円)
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
回転角度。