タイムラインを使用してトランジション、ビジュアルエフェクト、フィルターを設定する - Intelligent Media Services

このトピックでは、タイムラインパラメーターを SubmitMediaProducingJob オペレーションで変更して、トランジション、ビジュアルエフェクト、フィルターを設定する方法について説明します。

使用方法

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

トランジション

トランジションの追加

最初と2番目のクリップの間に [ワイプライト] トランジションを追加します。トランジションのデフォルトの時間は 1 秒です。
2 番目と 3 番目のクリップの間に [パーリンノイズ] トランジションを追加し、[時間] を指定してトランジションの時間を 2 秒に設定します。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media",
            "Effects": [{
                "Type": "Transition",
                // wiperightトランジションを設定します。
                "SubType": "wiperight"
            }]
        }, {
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media",
            "Effects": [{
                "Type": "Transition",
                // perlinトランジションを設定します。
                "SubType": "perlin",
                // トランジションの時間を2秒に設定します。
                "Duration": 2
            }]
        }, {
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4"
        }]
    }]
}

ランダムトランジションの追加

SubTypeを random に設定して、最初と2番目のクリップの間にランダムトランジションを追加します。これは、使用可能なすべてのトランジションからランダムにトランジションが選択されて適用されることを示します。
SubTypeを wiperight,perlin に設定して、2 番目と 3 番目のクリップの間にランダムトランジションを追加します。これは、wiperightとperlinのいずれかがランダムにトランジションとして使用されることを示します。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Effects": [{
                "Type": "Transition",
                // ランダムトランジションを設定します。
                "SubType": "random"
            }]
        }, {
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Effects": [{
                "Type": "Transition",
                // wiperightとperlinからランダムにトランジションを選択します。
                "SubType": "wiperight,perlin"
            }]
        }, {
            "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4"
        }]
    }]
}

ビジュアルエフェクト

単一クリップへのビジュアルエフェクトの追加

最初のクリップに [水平方向のぼかし] エフェクトを追加します。この場合、ビジュアルエフェクトの設定フィールドは、対応するクリップのEffect配列に含める必要があります。開始時刻と終了時刻を指定しない場合、ビジュアルエフェクトはデフォルトで対応するクリップと同じ時間続きます。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Out": 5,
            "Effects": [{
                "Type": "VFX",
                // 水平方向のぼかし効果を設定します。
                "SubType": "h_blur"
            }]
        },{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Out": 5
        }]
    }]
}

ビデオ全体へのビジュアルエフェクトの追加

ビデオ全体に [水平方向のぼかし] エフェクトを追加します。この場合、ビジュアルエフェクトの設定フィールドは独立したEffectTracks配列に含める必要があり、どのクリップにも関連付けられていません。開始時刻と終了時刻を指定しない場合、ビジュアルエフェクトはデフォルトでビデオと同じ時間続きます。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Out": 5
        },{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Out": 5
        }]
    }],
    "EffectTracks": [{
        "EffectTrackItems": [{
            "Type": "VFX",
            // ビデオ全体に水平方向のぼかし効果を設定します。
            "SubType": "h_blur"
        }]
    }]
}

ビデオの一部へのビジュアルエフェクトの追加

TimelineInを 3 に、TimelineOutを 7 に設定して、ビデオの 3 秒目から 7 秒目の部分に [水平方向のぼかし] エフェクトを追加します。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Out": 5
        },{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Out": 5
        }]
    }],
    "EffectTracks": [{
        "EffectTrackItems": [{
            "Type": "VFX",
            // 水平方向のぼかし効果を設定します。
            "SubType": "h_blur",
            // エフェクトの開始時刻を3秒に設定します。
            "TimelineIn": 3,
            // エフェクトの終了時刻を7秒に設定します。
            "TimelineOut": 7
        }]
    }]
}

ランダムビジュアルエフェクトの追加

SubTypeを random に設定して、最初のクリップにランダムビジュアルエフェクトを追加します。これは、使用可能なすべてのエフェクトからランダムにビジュアルエフェクトが選択されて適用されることを示します。
SubTypeを movie,image_in_image に設定して、2番目のクリップにランダムビジュアルエフェクトを追加します。これは、movieとimage_in_imageのいずれかがランダムにビジュアルエフェクトとして使用されることを示します。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Out": 5,
            "Effects": [{
                "Type": "VFX",
                // ランダムビジュアルエフェクトを設定します。
                "SubType": "random"
            }]
        }, {
            "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Out": 5,
            "Effects": [{
                "Type": "VFX",
                // movieとimage_in_imageからランダムにビジュアルエフェクトを選択します。
                "SubType": "movie,image_in_image"
            }]
        }]
    }]
}

フィルター

単一クリップへのフィルターの追加

最初のクリップに [グレーオレンジ] フィルターを追加します。この場合、フィルター設定フィールドは、対応するクリップのEffect配列に含める必要があります。開始時刻と終了時刻を指定しない場合、フィルターはデフォルトで対応するクリップと同じ時間続きます。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Out": 5,
            "Effects": [{
                "Type": "Filter",
                // グレーオレンジフィルターを設定します。
                "SubType": "m7"
            }]
        },{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Out": 5
        }]
    }]
}

ビデオ全体へのフィルターの追加

ビデオ全体に [グレーオレンジ] フィルターを追加します。この場合、フィルター設定フィールドは独立したEffectTracks配列に含める必要があり、どのクリップにも関連付けられていません。開始時刻と終了時刻を指定しない場合、フィルターはデフォルトでビデオと同じ時間続きます。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Out": 5
        },{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Out": 5
        }]
    }],
    "EffectTracks": [{
        "EffectTrackItems": [{
            "Type": "Filter",
            // ビデオ全体にグレーオレンジフィルターを設定します。
            "SubType": "m7"
        }]
    }]
}

ビデオの一部へのフィルターの追加

TimelineInを 3 に、TimelineOutを 7 に設定して、ビデオの 3 秒目から 7 秒目の部分に [グレーオレンジ] フィルターを追加します。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Out": 5
        },{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Out": 5
        }]
    }],
    "EffectTracks": [{
        "EffectTrackItems": [{
            "Type": "Filter",
            // グレーオレンジフィルターを設定します。
            "SubType": "m7",
            // フィルターの開始時刻を3秒に設定します。
            "TimelineIn": 3,
            // フィルターの終了時刻を7秒に設定します。
            "TimelineOut": 7
        }]
    }]
}

ビデオカラーグレーディング

Filterの下のSubTypeを color に設定して、ビデオの色を編集できます。

次の例では、設定はビデオの 3 秒目から 7 秒目に適用されます。

明るさを -10 に設定して、明るさを下げます。
コントラストを 10 に設定して、コントラストを上げます。
彩度を 10 に設定して、彩度を上げます。
dark_corner_ratioを 50 に設定して、周辺光量落ち効果を上げます。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Out": 5
        },{
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Out": 5
        }]
    }],
    "EffectTracks": [{
        "EffectTrackItems": [{
            "Type": "Filter",
            // カラーフィルターを設定します。
            "SubType": "color",
            // フィルターの開始時刻を3秒に設定します。
            "TimelineIn": 3,
            // フィルターの終了時刻を7秒に設定します。
            "TimelineOut": 7,
            // カラーグレーディングパラメーターを設定します。
            "ExtParams": "effect=color,brightness=-10,contrast=10,saturation=10,kelvin_temperature=6000,temperature_ratio=0,tint=0,dark_corner_ratio=50"
        }]
    }]
}

ランダムフィルターの追加

SubTypeを random に設定して、最初のクリップにランダムフィルターを追加します。これは、使用可能なすべてのフィルターからランダムにフィルターが選択されて適用されることを示します。

SubTypeを pj2,pj3 に設定して、2番目のクリップにランダムフィルターを追加します。これは、pj2とpj3のいずれかがランダムにフィルターとして使用されることを示します。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Out": 5,
            "Effects": [{
                "Type": "Filter",
                // ランダムフィルターを設定します。
                "SubType": "random"
            }]
        }, {
            "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Out": 5,
            "Effects": [{
                "Type": "Filter",
                // pj2とpj3からランダムにフィルターを選択します。
                "SubType": "pj2,pj3"
            }]
        }]
    }]
}

ケン・バーンズ効果

画像をビデオに変換したり、フォトアルバムを作成したりするときに、ケン・バーンズ効果を適用できます。

次の設定例では、左下隅の元の画像から右上隅にパンするケン・バーンズ効果を追加します。

エフェクト

図

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "Type": "Image",
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.png",
            "Duration": 5,
            "Effects": [{
                "Type": "KenBurns",
                // ケン・バーンズ効果の開始位置とズームレベルを設定します。
                "Start": "0,0.5,0.5,0.5",
                // ケン・バーンズ効果の終了位置とズームレベルを設定します。
                "End": "0.5,0,0.5,0.5"
            }]
        }]
    }]
}

デフォルトエフェクト

KenBurnsパラメーターを設定しない場合、アニメーションは次の動作をします。

入力と出力が両方とも横長または縦長モードの場合、エフェクトは低速ズームアウトになります。
入力が横長モードで出力が縦長モードの場合、エフェクトは右方向への低速スライドになります。
入力が縦長モードで出力が横長モードの場合、エフェクトは下方向への低速スライドになります。

デフォルトエフェクト 1：入力と出力が両方とも横長または縦長モードの場合の低速ズームアウト

エフェクト

図

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "Type": "Image",
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.png",
            "Duration": 5,
            "Effects": [{
                // デフォルトのケン・バーンズ効果を設定します。
                "Type": "KenBurns"
            }]
        }]
    }]
}

デフォルトエフェクト 2：入力が横長モードで出力が縦長モードの場合の右方向への低速スライド

エフェクト

図

タイムラインの例

OutputMediaConfigの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "Type": "Image",
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/h1.png",
            "Duration": 5,
            "Effects": [{
                // デフォルトのケン・バーンズ効果を設定します。
                "Type": "KenBurns"
            }]
        }]
    }]
}

Widthを 1080 に、Heightを 1920 に設定して、出力を縦長モードに設定します。

{
    "MediaURL": "メディアアセットのOSS URLを指定します",
    "Width": 1080,
    "Height": 1920
}

デフォルトエフェクト 3：入力が縦長モードで出力が横長モードの場合の下方向への低速スライド

エフェクト

図

タイムラインの例

OutputMediaConfigの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "Type": "Image",
            "MediaURL": "https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/test_media/v1.jpg",
            "Duration": 5,
            "Effects": [{
                // デフォルトのケン・バーンズ効果を設定します。
                "Type": "KenBurns"
            }]
        }]
    }]
}

Widthを 1920 に、Heightを 1080 に設定して、出力を横長モードに設定します。

{
    "MediaURL": "メディアアセットのOSS URLを指定します",
    "Width": 1920,
    "Height": 1080
}

トランジション、ビジュアルエフェクト、フィルターをまとめて設定する

次の例は、フィルター、ビジュアルエフェクト、トランジションを組み合わせた設定を示しています。

最初と 2 番目のクリップの間にランダムトランジションを追加します。
2 番目と 3 番目のクリップの間に [パーリンノイズ] トランジションを追加します。
最初のクリップに [円形フラッシュライト付き] という名前のビジュアルエフェクトを追加します。
2 番目のクリップに [pl3] という名前のフィルターを追加します。
ビデオの 11 秒目から 13 秒目の部分に [ウォーム] という名前のフィルターを追加します。

エフェクト

タイムラインの例

{
    "VideoTracks": [{
        "VideoTrackClips": [{
            "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h1.mp4",
            "Out": 6,
            "Effects": [{
                "Type": "Transition",
                // ランダムトランジションを設定します。
                "SubType": "random",
                "Duration": 1
            }, {
                "Type": "VFX",
                // 円形フラッシュライト付きのビジュアルエフェクトを設定します。
                "SubType": "withcircleflashlight"
            }]
        }, {
            "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h2.mp4",
            "Out": 6,
            "Effects": [{
                "Type": "Transition",
                // perlinトランジションを設定します。
                "SubType": "perlin",
                "Duration": 1
            }, {
                "Type": "Filter",
                // pl3フィルターを設定します。
                "SubType": "pl3"
            }]
        }, {
            "MediaURL": "http://ice-public-media.oss-cn-shanghai.aliyuncs.com/test_media/h3.mp4",
            "Out": 5
        }]
    }],
    "EffectTracks": [{
        "EffectTrackItems": [{
            "Type": "Filter",
            // warmフィルターを設定します。
            "SubType": "warm",
            // フィルターの開始時刻を11秒に設定します。
            "TimelineIn": 11,
            // フィルターの終了時刻を13秒に設定します。
            "TimelineOut": 13
        }]
    }]
}

使用方法

トランジション

トランジションの追加

ランダムトランジションの追加

ビジュアルエフェクト

単一クリップへのビジュアルエフェクトの追加

ビデオ全体へのビジュアルエフェクトの追加

ビデオの一部へのビジュアルエフェクトの追加

ランダムビジュアルエフェクトの追加

フィルター

単一クリップへのフィルターの追加

ビデオ全体へのフィルターの追加

ビデオの一部へのフィルターの追加

ビデオカラーグレーディング

ランダムフィルターの追加

ケン・バーンズ効果

デフォルトエフェクト

デフォルトエフェクト 1：入力と出力が両方とも横長または縦長モードの場合の低速ズームアウト

デフォルトエフェクト 2：入力が横長モードで出力が縦長モードの場合の右方向への低速スライド

デフォルトエフェクト 3：入力が縦長モードで出力が横長モードの場合の下方向への低速スライド

トランジション、ビジュアルエフェクト、フィルターをまとめて設定する

参照