ApsaraVideo VOD:効果の設定

パラメーター

タイプ

必須

説明

X

浮く

任意

テキストの左上隅と出力ビデオの左上隅の間の水平距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。 デフォルト値：0 座標は、ソースと出力ビデオのサイズに基づいてスケーリングされます。

Y

浮く

任意

テキストの左上隅と出力ビデオの左上隅の間の垂直距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。 デフォルト値：0 座標は、ソースと出力ビデオのサイズに基づいてスケーリングされます。

TimelineIn

浮く

任意

テキストがタイムラインに表示される時刻。 単位は秒です。 値は小数点以下4桁まで正確です。 このパラメーターを指定しない場合、クリップのTimelineIn値が使用されます。

TimelineOut

浮く

任意

テキストがタイムラインに表示されなくなった時刻。 単位は秒です。 値は小数点以下4桁まで正確です。 このパラメーターを指定しない場合、クリップのTimelineOut値が使用されます。

Content

String

必須

バナーテキストの内容。

フォント

String

任意

バナーテキストのフォント。 デフォルト値: SimSun。

サポートされているフォントの詳細については、「フォント」をご参照ください。

FontSize

Int

必須

バナーテキストのフォントサイズ。 フォントサイズは、マテリアルと出力ビデオのサイズに基づいてスケーリングされます。

FixedFontSize

Int

必須

バナーテキストのフォントサイズ。 フォントサイズは、マテリアルと出力ビデオのサイズに基づいてスケーリングされません。

FixedX

浮く

任意

テキストの左上隅と出力ビデオの左上隅の間の水平距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。 デフォルト値：0 座標は、マテリアルと出力ビデオのサイズに基づいてスケーリングされません。

FixedY

浮く

任意

テキストの左上隅と出力ビデオの左上隅の間の水平距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。 デフォルト値：0 座標は、マテリアルと出力ビデオのサイズに基づいてスケーリングされません。

FontColor

String

任意

16進形式のテキストの色。 値は数字記号 (#) で始まります。

例: #ffffff.

FontColorOpacity

String

任意

バナーテキストの透明度。 有効な値は 0～1 です。 1はテキストが透明でないことを示し、0はテキストが完全に透明であることを示します。 デフォルト値は 1 です。

フォントフェイス

フォントフェイス

任意

バナーテキストの外観。

パディング

Integer

任意

バナーテキストの単語間隔。 単位: ピクセル。 デフォルト値：0

角度

浮く

任意

バナーテキストの反時計回りの回転角度。 単位は度で、 デフォルト値：0

BorderStyle

Int

任意

バナーテキストの境界線のスタイル。 有効な値: 1と3。 1はテキストに境界と影があることを示し、3はテキストに背景があることを示します。 デフォルト値は 1 です。

概要

Int

任意

バナーテキストのストローク幅。 単位: ピクセル。 デフォルト値：0

OutlineColour

String

任意

16進形式のバナーテキストの線の色。 値は数字記号 (#) で始まります。 例: #ffffff.

影

Int

任意

バナーテキストの影のサイズ。 単位: ピクセル。 デフォルト値：0

バックカラー

String

任意

16進形式のバナーテキストの影の色。 値は数字記号 (#) で始まります。 例: #ffffff.

整列

String

任意

バナーテキストの場所。 デフォルト値: TopLeft。 有効な値：

• トップ左

• TopCenter

• TopRight

• センター左

• CenterCenter

• センターライト

• BottomLeft

• BottomCenter

• BottomRight

AdaptMode

String

任意

バナーテキストの幅がビデオの幅または指定したTextWidthを超えた場合に、自動改行または自動スケーリングを有効にするかどうかを示します。 有効な値：

• AutoWrap: 自動改行を有効にします

• AutoScale: 自動スケーリングを有効にする

• AutoWrapAtSpaces: テキストが英語で表示されている場合にのみ、空白を使用してテキストを自動的にラップします。

テキスト幅

String

任意

テキストボックスの幅。 このパラメーターは、AdaptModeを指定すると有効になります。 このパラメーターは、自動改行または自動スケーリングを有効にするときに使用されます。 このパラメーターを指定しない場合、ビデオ幅に基づいて自動改行または自動スケーリングが実行されます。 単位: ピクセル。

FontUrl

String

任意

Object Storage Service (OSS) 内のフォントファイルのURL。 フォントファイルの形式は、ttf、otf、woffです。

例: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf.

EffectColorStyle

String

任意

バナーテキストのワードアート効果。

ワードアート効果の詳細については、「ワードアート効果の例」をご参照ください。

AaiMotionInEffect

String

任意

バナーテキストの入り口効果。

エントランスエフェクトの詳細については、「エントランスエフェクト」をご参照ください。

AaiMotionIn

浮く

任意

入り口効果の持続時間。 単位は秒です。 値は小数点以下4桁まで正確です。 AaiMotionInを指定しない場合、このパラメーターのデフォルト値は0.5秒です。 バナーテキストが0.5秒未満表示されている場合、エントランスエフェクトの持続時間は、バナーテキストの合計持続時間から終了エフェクトの持続時間を引いたものになります。

AaiMotionOutEffect

String

任意

バナーテキストの終了効果。

終了効果の詳細については、「終了効果」をご参照ください。

AaiMotionOut

浮く

任意

終了効果の持続時間。 単位は秒です。 値は小数点以下4桁まで正確です。 AaiMotionOutを指定しない場合、このパラメーターのデフォルト値は0.5秒です。 バナーテキストが0.5秒未満で表示されている場合、終了効果の時間はバナーテキストの合計時間になります。

AaiMotionLoopEffect

String

任意

バナーテキストのループ効果。 ループ効果は、入口効果または出口効果とともに有効にすることはできません。

ループ効果の詳細については、「ループ効果」をご参照ください。

比率

浮く

任意

ループ効果の速度。 値は小数点以下4桁まで正確です。 このパラメーターを指定しない場合、デフォルトで1が使用されます。 1より大きい値は、より高いループ速度を示し、1より小さい値は、より遅いループ速度を示します。

パラメーター

タイプ

必須

説明

X

浮く

任意

ぼかし領域の左上隅と出力ビデオの左上隅の間の水平距離。 値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数の場合、値はピクセルの数を示します。 デフォルト値：0

Y

浮く

任意

ぼかし領域の左上隅と出力ビデオの左上隅の間の垂直距離。 値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数の場合、値はピクセルの数を示します。 デフォルト値：0

幅

浮く

必須

出力ビデオのぼかし領域の幅。 値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数の場合、値はピクセルの数を示します。

Height

浮く

必須

出力ビデオのぼかし領域の高さ。 値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。

TimelineIn

浮く

任意

タイムラインで領域がぼやけている時刻。 単位は秒です。 値は小数点以下4桁まで正確です。 このパラメーターを指定しない場合、クリップのTimelineIn値が使用されます。

TimelineOut

浮く

任意

タイムラインで領域がぼやけなくなる時刻。 単位は秒です。 値は小数点以下4桁まで正確です。 このパラメーターを指定しない場合、クリップのTimelineOut値が使用されます。

パラメーター

タイプ

必須

説明

X

浮く

任意

トリミング後のビデオ画像の左上隅と出力ビデオの左上隅との間の水平距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示します。 デフォルト値：0

Y

浮く

任意

トリミング後のビデオ画像の左上隅と出力ビデオの左上隅との間の垂直距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。 デフォルト値：0

幅

浮く

必須

トリミング後の出力ビデオのビデオ画像の幅。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。

Height

浮く

必須

トリミング後の出力ビデオのビデオ画像の高さ。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。

パラメーター

タイプ

必須

説明

幅

浮く

必須

スケーリング後の出力ビデオのビデオイメージの幅。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が1以上の整数である場合、値はピクセルの数を示す。

Height

浮く

必須

スケーリング後の出力ビデオのビデオ画像の高さ。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が1以上の整数である場合、値はピクセルの数を示す。

パラメーター

タイプ

必須

説明

左揃え

浮く

任意

マテリアルの左側と出力ビデオの左側の間の距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が1以上の整数である場合、値はピクセルの数を示す。

右揃え

浮く

任意

マテリアルの右側と出力ビデオの右側の間の距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が1以上の整数である場合、値はピクセルの数を示す。

上

浮く

任意

マテリアルの上部と出力ビデオの上部の間の距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が1以上の整数である場合、値はピクセルの数を示す。

下

浮く

任意

マテリアルの下部と出力ビデオの下部の間の距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が1以上の整数である場合、値はピクセルの数を示す。

色

String

任意

16進形式のパディングの色。 値は番号記号 (#) で始まる必要があります。 例: #000000。 デフォルトの色は黒です。

パラメーター

タイプ

必須

説明

サブタイプ

String

必須

背景設定のタイプ。 有効な値：

ぼかし機能

色

半径

浮く

任意

ぼかし半径。 このパラメーターは、SubTypeがBlurに設定されている場合にのみ有効です。 有効値: [0.01,1] 。

色

String

任意

16進形式のRGBカラー値。 このパラメーターは、SubTypeがColorに設定されている場合にのみ有効です。

例: #FFFFFF。

パラメーター

タイプ

必須

説明

サブタイプ

String

必須

トランジション効果のタイプ。 複数のトランジション効果を指定し、コンマ (,) で区切ることができます。 次に、システムは、遷移効果の1つをランダムに選択する。 または、ランダムを指定して、システムがすべてのトランジション効果からトランジション効果をランダムに選択できるようにすることもできます。 有効な値と効果の詳細については、「トランジション効果の例」をご参照ください。

例: directional.

有効期間

浮く

任意

トランジション効果の持続時間。 単位は秒です。 値は小数点以下4桁まで正確です。 デフォルト値は 1 です。

パラメーター

タイプ

必須

説明

サブタイプ

String

必須

視覚効果のタイプ。 複数の視覚効果を指定し、コンマ (,) で区切ることができます。 次いで、システムは、視覚効果の1つをランダムに選択する。 または、ランダムを指定して、システムがすべての視覚効果から視覚効果をランダムに選択できるようにすることもできます。 有効な値と効果の詳細については、「特殊効果の例」をご参照ください。

例: colorfulradial.

X

浮く

任意

このパラメーターは、SubTypeがmosaic_rect/blurに設定されている場合にのみ有効です。 視覚効果領域の左上隅と出力ビデオの左上隅の間の水平距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。

Y

浮く

任意

このパラメーターは、SubTypeがmosaic_rect/blurに設定されている場合にのみ有効です。

視覚効果領域の左上隅と出力ビデオの左上隅の間の垂直距離。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。

幅

浮く

任意

このパラメーターは、SubTypeがmosaic_rect/blurに設定されている場合にのみ有効です。 出力ビデオの視覚効果領域の幅。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。

Height

浮く

任意

このパラメーターは、SubTypeがmosaic_rect/blurに設定されている場合にのみ有効です。 出力ビデオの視覚効果領域の高さ。

値をパーセンテージまたはピクセル数に設定できます。 値の範囲が0から0.9999の場合、値はパーセンテージを示します。 値が2以上の整数である場合、値はピクセルの数を示す。

パラメーター

タイプ

必須

説明

サブタイプ

String

必須

フィルターのタイプ。 複数のフィルターを指定し、コンマ (,) で区切ることができます。 次に、システムはフィルタの1つをランダムに選択します。 または、ランダムを指定して、システムがすべてのフィルターからフィルターをランダムに選択できるようにすることもできます。 有効な値と効果の詳細については、「フィルター効果の例」をご参照ください。

例: M1

TimelineIn

浮く

任意

フィルターがタイムラインで適用される時刻。 単位は秒です。 値は小数点以下4桁まで正確です。 このパラメーターを指定しない場合、クリップのTimelineIn値が使用されます。

TimelineOut

浮く

任意

タイムラインでフィルターが解除された時刻。 単位は秒です。 値は小数点以下4桁まで正確です。 このパラメーターを指定しない場合、クリップのTimelineOut値が使用されます。

ExtParams

String

任意

フィルターに関連するパラメーター。 このパラメーターは、SubTypeがcolorに設定されている場合にのみ有効です。 この場合、調色フィルタが適用される。 ExtParamsの設定の詳細については、「ExtParams」をご参照ください。

パラメーター

タイプ

有効値

説明

デフォルト値

明るさ

int

[-255,255]

画像輝度

0

コントラスト

int

[-100,100]

コントラスト

0

彩度

int

[-100,100]

彩度

0

kelvin_temperature

int

[1000,40000]

色温度。 このパラメーターは、temperature_ratioを指定すると有効になります。

temperature_ratio

6000

temperature_ratio

int

[0,100]

色温度の比率。

0

色合い

int

[-100,100]

色合い

0

dark_corner_ratio

int

[0,100]

ビネッティング

0

パラメーター

タイプ

必須

説明

ゲイン

浮く

任意

ボリューム。 有効な値: 0〜10。 値が小さいほどボリュームが小さいことを示す。 0はミュート、1は元のボリュームを示します。 デフォルト値は 1 です。

パラメーター

タイプ

必須

説明

サブタイプ

String

必須

オーディオのフェージングのタイプ。 有効な値：

• この場合、顧客 ID、つまり MD5 (customer-id) のハッシュ値を計算し、ファイル名のプレフィックスとして数文字のハッシュプレフィックスを組み合わせることができます。

• アウト

有効期間

浮く

任意

オーディオフェージングの持続时间。 オーディオのフェードインはマテリアルの最初に適用され、オーディオのフェードアウトはマテリアルの最後に適用されます。 デフォルト値：0 0は、オーディオフェージングが適用されないことを示す。

カーブ

String

任意

オーディオフェージングのボリュームカーブ。 デフォルト値: exp。

有効な値：

• exp: 指数曲線

• tri: リニアカーブ

パラメーター

タイプ

必須

説明

学位

Integer

必須

時計回り方向の回転角度。 マテリアルを90度、180度、または270度だけ回転させることができます。

パラメーター

タイプ

必須

説明

サブタイプ

String

必須

キャプチャのタイプ。 有効値: RandomClip。

クリップ期間

浮く

必須

ビデオトラッククリップのデュレーション。

パラメーター

タイプ

必須

説明

方向

String

必須

• 水平: x軸に沿ってビデオまたは画像を反転します

• 垂直: ビデオまたは画像をy軸に沿って反転します

パラメーター

タイプ

必須

説明

例

有効期間

浮く

任意

効果の持続時間。 デフォルト値: クリップの長さ。 単位は秒です。 最大値: 10。

5

WindowW

浮く

任意

クリップの幅。 デフォルトでは、値は出力ビデオの幅に等しくなります。 単位: ピクセル。

WindowWの値が (0,1) の範囲にある場合、値は相対値です。 値が1より大きい場合、値は絶対値です。

1

WindowH

浮く

任意

クリップの高さ。 デフォルトでは、値は出力ビデオの高さに等しくなります。 単位: ピクセル。

WindowHの値が (0,1) の範囲にある場合、値は相対値です。

値が1より大きい場合、値は絶対値です。

1

開始

String

任意

Ken Burnsエフェクトが適用される前のエフェクトエリアの位置。 位置は、左上隅のx座標とy座標、および効果領域の幅と高さによって決まります。 これは任意のパラメーターです。 値はコンマ (,) で区切る必要があります。

"StartX、StartY、StartW、StartH"

次のルールが適用されます。

0 < StartX + StartW <=1

0 < StartY + StartH <=1

「0,0、0.9、0.9」

StartX

浮く

任意

Ken Burnsエフェクトが適用される前のエフェクトエリアの左上隅のx座標。 単位: ピクセル。

StartXの値が [0,1) の範囲内にある場合、値は相対値です。

値が1以上の場合、値は絶対値です。

0

スタートY

浮く

任意

Ken Burnsエフェクトが適用される前のエフェクトエリアの左上隅のy座標。 単位: ピクセル。

StartYの値が [0,1) の範囲内にある場合、値は相対値です。

値が1以上の場合、値は絶対値です。

0

スタートW

浮く

任意

Ken Burnsエフェクトが適用される前のエフェクトエリアの幅。 単位: ピクセル。

StartWの値が (0,1) の範囲内であれば、その値は相対値である。

値が1より大きい場合、値は絶対値です。

0.9

スタートH

浮く

任意

Ken Burnsエフェクトが適用される前のエフェクトエリアの高さ。 単位: ピクセル。

StartHの値が (0,1) の範囲内であれば、その値は相対値である。

値が1より大きい場合、値は絶対値です。

0.9

完了

String

任意

Ken Burnsエフェクトが適用された後のエフェクトエリアの位置。 位置は、左上隅のx座標とy座標、および効果領域の幅と高さによって決まります。 これは任意のパラメーターです。 値はコンマ (,) で区切る必要があります。

「EndX、EndY、EndW、EndH」

次のルールが適用されます。

0 < EndX + EndW <=1

0 < EndY + EndH <=1

「0,0、1,1」

EndX

浮く

任意

Ken Burnsエフェクトが適用された後のエフェクトエリアの左上隅のx座標。 単位: ピクセル。

StartXの値が [0,1) の範囲内にある場合、値は相対値です。

値が1以上の場合、値は絶対値です。

0

エンド

浮く

任意

Ken Burnsエフェクトが適用された後のエフェクトエリアの左上隅のy座標。 単位: ピクセル。

StartYの値が [0,1) の範囲内にある場合、値は相対値です。

値が1以上の場合、値は絶対値です。

0

EndW

浮く

任意

Ken Burnsエフェクトを適用した後のエフェクトエリアの幅。 単位: ピクセル。

StartWの値が (0,1) の範囲内であれば、その値は相対値である。

値が1より大きい場合、値は絶対値です。

1

EndH

浮く

任意

Ken Burnsエフェクトが適用された後のエフェクトエリアの高さ。 単位: ピクセル。

StartHの値が (0,1) の範囲内であれば、その値は相対値である。

値が1より大きい場合、値は絶対値です。

1

パラメーター

タイプ

必須

説明

開始率

浮く

任意

• 現在のズーム値。

• デフォルト値: 1.0

• 有効な値: [1.0,5.0] 。

エンドレート

浮く

任意

• 目的のズーム値。

• デフォルト値: StartRateと0.3の値。

• 有効な値: [StartRate,5.0]

有効期間

浮く

任意

• ズーム効果の持続時間。

• デフォルト値: クリップのレンダリング時間。

• 有効値: [0,clip rendering duration]