エフェクトの構造は、そのタイプによって異なります。このトピックでは、さまざまなタイプのエフェクトの構造について説明します。
エフェクトタイプ: テキスト (バナーテキスト)
タイムラインの例: 字幕と字幕テンプレート
名前 | タイプ | 必須 | 説明 |
X | Float | いいえ | バナーテキストの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。座標は、素材と出力ビデオのディメンションに基づいてスケーリングされます。 |
Y | Float | いいえ | バナーテキストの左上隅から出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。座標は、素材と出力ビデオのディメンションに基づいてスケーリングされます。 |
TimelineIn | Float | いいえ | タイムライン上のバナーテキストの開始時間 (秒単位)。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、値は対応するクリップの TimelineIn と同じになります。 |
TimelineOut | Float | いいえ | タイムライン上のバナーテキストの終了時間 (秒単位)。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、値は対応するクリップの TimelineOut と同じになります。 |
Content | String | はい | バナーテキストの内容。 |
Font | String | いいえ | バナーテキストのフォント。サポートされているフォントのリストについては、「フォントリスト」をご参照ください。デフォルトのフォントは SimSun です。 |
FontSize | Int | はい | バナーテキストのフォントサイズ。このフォントサイズは、素材と出力ビデオのディメンションに基づいてスケーリングされます。デフォルト値は 0 です。最大値は 5000 です。 注:
|
SizeRequestType | String | いいえ | フォントサイズからテキストの実際のレンダリングサイズを計算するために使用されるメソッド。デフォルト値は RealDim です。
|
FixedFontSize | Int | はい | テロップテキストのフォントサイズ。このフォントサイズは、素材と出力ビデオのディメンションに基づいてスケーリングされません。 注:
|
FixedX | Float | いいえ | バナーテキストの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。この座標は、素材と出力ビデオのディメンションに基づいてスケーリングされません。 |
FixedY | Float | いいえ | バナーテキストの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。この座標は、素材と出力ビデオのディメンションに基づいてスケーリングされません。 |
FontColor | String | いいえ | テロップテキストの色。フォーマットは、シャープ記号 (#) の後に 16 進数が続く形式です。例: #ffffff。 |
FontColorOpacity | String | いいえ | テロップテキストの不透明度。値の範囲は 0 から 1 です。値 1 はテキストが不透明であることを意味します。値 0 はテキストが完全に透明であることを意味します。デフォルト値は 1 です。 |
FontFace | FontFace | いいえ | バナーテキストのフォントフェイス。 |
Spacing | Integer | いいえ | バナーテキストの文字間隔 (ピクセル単位)。デフォルト値は 0 です。 |
LineSpacing | Integer | いいえ | バナーテキストの行間 (ピクセル単位)。デフォルト値は 0 です。 |
Angle | Float | いいえ | バナーテキストの反時計回りの回転角度 (度単位)。デフォルト値は 0 です。 |
BorderStyle | Int | いいえ | バナーテキストの罫線と影のスタイル。有効な値は 1 と 3 です。1: 罫線と影。3: 不透明なバックグラウンドボックス。デフォルト値は 1 です。 |
Outline | Int | いいえ | バナーテキストのアウトラインの幅 (ピクセル単位)。デフォルト値は 0 です。 |
OutlineColour | String | いいえ | テロップテキストのアウトラインの色。フォーマットは、シャープ記号 (#) の後に 16 進数が続く形式です。例: #ffffff。 |
Shadow | Int | いいえ | バナーテキストによってキャストされる影の深さ (ピクセル単位)。デフォルト値は 0 です。 |
BackColour | String | いいえ | テロップテキストの影の色。フォーマットは、シャープ記号 (#) の後に 16 進数が続く形式です。例: #ffffff。 |
Alignment | String | いいえ | テロップテキストの配置。デフォルト値は TopLeft です。有効な値:
異なる配置の字幕を正確に配置するには、次のように配置を設定します。
|
AdaptMode | String | いいえ | ビデオの幅または指定された TextWidth を超えるバナーテキストを処理する方法:
|
TextWidth | String | いいえ | 字幕テキストボックスの幅。このパラメーターは、AdaptMode が設定されている場合にのみ有効になります。テキストは、この幅に基づいて折り返されるか、スケーリングされます。このパラメーターを指定しない場合、テキストはビデオの幅に基づいて折り返されるか、スケーリングされます。(0, 1] の開閉区間の値は、出力ビデオの幅のパーセンテージを表します。1 より大きい値は、絶対ピクセル値を表します。 |
FontUrl | String | いいえ | バナーテキストに使用する OSS バケット内のフォントファイルのパス。TTF、OTF、および WOFF 形式がサポートされています。例: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf |
EffectColorStyle | String | いいえ | バナーテキストのアートテキストスタイルタイプ。詳細については、「アートテキストエフェクトの例」をご参照ください。 |
SubtitleEffects | いいえ | バナーテキストの多層エフェクト。多層アウトライン、多層シャドウ、ガウスぼかし (シャドウのみ)、および字幕バックグラウンドエフェクトを設定できます。 注:
| |
AaiMotionInEffect | String | いいえ | バナーテキストの入場エフェクトタイプ。詳細については、「字幕エフェクトの例」をご参照ください。 |
AaiMotionIn | Float | いいえ | バナーテキストの入場エフェクトの期間 (秒単位)。値は小数点以下 4 桁まで正確です。デフォルト値は 0.5 秒です。テキストの期間が 0.5 秒未満の場合、入場エフェクトの期間は、合計期間から退場エフェクトの期間を引いたものになります。 |
AaiMotionOutEffect | String | いいえ | バナーテキストの退場エフェクトタイプ。詳細については、「字幕エフェクトの例」をご参照ください。 |
AaiMotionOut | Float | いいえ | バナーテキストの退場エフェクトの期間 (秒単位)。値は小数点以下 4 桁まで正確です。デフォルト値は 0.5 秒です。テキストの期間が 0.5 秒未満の場合、退場エフェクトの期間はテキストの合計期間になります。 |
AaiMotionLoopEffect | String | いいえ | バナーテキストのループエフェクトタイプ。このエフェクトは、入場または退場エフェクトと併用することはできません。詳細については、「字幕エフェクトの例」をご参照ください。 |
Ratio | Float | いいえ | バナーテキストのループエフェクトの再生速度。値は小数点以下 4 桁まで正確です。デフォルト値は 1 です。1 より大きい値はループが速いことを示します。1 より小さい値はループが遅いことを示します。 |
TextureURL | String | いいえ | 字幕のテクスチャエフェクト。PNG、JPG、JPEG、および BMP 形式がサポートされています。OSS ファイルを使用する必要があります。例: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png |
BubbleStyleId | String | いいえ | バナーテキストの吹き出しテキストスタイルタイプ。吹き出しのタイプとエフェクトについては、「吹き出しテキストの例」をご参照ください。 |
BubbleWidth | Float | いいえ | このパラメーターは、吹き出しテキストを使用する場合にのみ有効になります。出力ビデオに対する吹き出しバックグラウンドの幅を指定します。1 より大きい値は絶対ピクセル値を表します。1 以下の値は相対値を表します。 |
BubbleHeight | Float | いいえ | このパラメーターは、吹き出しテキストを使用する場合にのみ有効になります。出力ビデオに対する吹き出しバックグラウンドの高さを指定します。1 より大きい値は絶対ピクセル値を表します。1 以下の値は相対値を表します。 |
エフェクトタイプ: DeWatermark (マスキング)
名前 | タイプ | 必須 | 説明 |
X | Float | いいえ | マスキングエリアの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。 |
Y | Float | いいえ | マスキングエリアの左上隅から出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。 |
Width | Float | はい | 出力ビデオ内のマスキングエリアの幅。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。 |
Height | Float | はい | 出力ビデオ内のマスキングエリアの高さ。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。 |
エフェクトタイプ: トリミング
タイムラインの例: ビデオのトリミング
名前 | タイプ | 必須 | 説明 |
X | Float | いいえ | トリミングされたエリアの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。 |
Y | Float | いいえ | トリミングされたエリアの左上隅から出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。デフォルト値は 0 です。 |
Width | Float | はい | 出力ビデオ内のトリミングされたエリアの幅。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。 |
Height | Float | はい | 出力ビデオ内のトリミングされたエリアの高さ。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。 |
エフェクトタイプ: スケール
注: スケールエフェクトを指定せず、素材の縦横比が出力ビデオの縦横比と一致しない場合、素材は出力ビデオの幅または高さのいずれかに合わせて自動的にスケーリングされます。上下または左右に黒いバーが追加され、素材は中央に配置されます。
タイムラインの例: スケール構成
名前 | タイプ | 必須 | 説明 |
Width | Float | はい | 出力ビデオ内のスケーリングされたエリアの幅。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。 |
Height | Float | はい | 出力ビデオ内のスケーリングされたエリアの高さ。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。 |
エフェクトタイプ: Pad (パディング)
注: Pad エフェクトを指定せず、素材の縦横比が出力ビデオの縦横比と一致しない場合、素材は出力ビデオの幅または高さのいずれかに合わせて自動的にスケーリングされます。上下または左右に黒いバーが追加され、素材は中央に配置されます。
タイムラインの例: 横長のビデオを縦長のビデオに変換し、上下にぼかしエリアを追加する
名前 | タイプ | 必須 | 説明 |
Left | Float | いいえ | 素材の左端から出力ビデオの左端までの距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。 |
Right | Float | いいえ | 素材の右端から出力ビデオの右端までの距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。 |
Top | Float | いいえ | 素材の上端から出力ビデオの上端までの距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。 |
Bottom | Float | いいえ | 素材の下端から出力ビデオの下端までの距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。1 以上の整数は、絶対ピクセル値を表します。 |
Color | String | いいえ | パディングの色。フォーマットは、シャープ記号 (#) の後に 16 進数が続く形式です。例: #000000。デフォルトの色は黒です。 |
エフェクトタイプ: バックグラウンド
バックグラウンド設定には、バックグラウンドのぼかしとバックグラウンドカラーが含まれます。素材のディメンションが出力ビデオのディメンションと一致しない場合、このエフェクトを使用して空のエリアを構成できます。
バックグラウンドエフェクトは、トリミング、スケール、VFX、トランジションなどの他のエフェクトと併用できます。
タイムラインの例: 横長のビデオを縦長のビデオに変換し、バックグラウンドカラーを設定する
名前 | タイプ | 必須 | 説明 |
SubType | String | はい | サブタイプ。有効な値: Blur: バックグラウンドのぼかし Color: バックグラウンドカラー |
Radius | Float | いいえ | ぼかしの半径。このパラメーターは、SubType が Blur に設定されている場合にのみ有効になります。値の範囲は 0.01 から 1 です。 |
Color | String | いいえ | 色の値。このパラメーターは、SubType が Color に設定されている場合にのみ有効になります。16 進数の RGB 形式で色を指定します。例: #FFFFFF |
エフェクトタイプ: トランジション
このトランジションは、2 つの連続する素材のレイヤーを重ねることで作成されるため、最終的なビデオの期間が短くなります。これを避けるには、このトピックの後半で説明する DLTransition (期間ロックトランジション) エフェクトを使用します。
トランジションエフェクトは、2 つの素材の間で発生します。最初の素材にトランジションの期間を設定するだけで済みます。エフェクトは、最初の素材の終わりと 2 番目の素材の始まりに適用されます。トランジション中、ビデオフレームは重複し、トランジションの長さだけ合計期間が短縮されます。
たとえば、ビデオトラックに 2 つのクリップ、Clip1 (10 秒) と Clip2 (8 秒) が含まれており、それらの間に 4 秒のトランジションを追加すると、ビデオトラックの合計期間は 18 秒から 14 秒に短縮されます。
次の表に、トランジションのプロパティを示します。トランジションエフェクトの詳細については、「トランジションエフェクトの例」をご参照ください。
タイムラインの例: トランジションタイムライン構成の例
名前 | タイプ | 必須 | 説明 |
SubType | String | はい | トランジションのサブタイプ。コンマで区切って複数のサブタイプを指定でき、その中から 1 つがランダムに選択されます。また、`random` を指定して、利用可能なすべてのサブタイプからランダムに選択することもできます。例: directional。値とそのエフェクトの完全なリストについては、「トランジションエフェクトの例」をご参照ください。 |
Duration | Float | いいえ | トランジションエフェクトの期間 (秒単位)。値は小数点以下 4 桁まで正確です。デフォルト値は 1 秒です。 |
エフェクトタイプ: DLTransition (期間ロックトランジション)
標準のトランジションエフェクトとは異なり、期間ロックトランジション (DLTransition) エフェクトは、トランジション期間を静止フレームで埋めるため、最終的なビデオの期間を短縮しません。
このエフェクトのパラメーターは、トランジションエフェクトのパラメーターと同じです。
名前 | タイプ | 必須 | 説明 |
SubType | String | はい | トランジションのサブタイプ。コンマで区切って複数のサブタイプを指定でき、その中から 1 つがランダムに選択されます。また、`random` を指定して、利用可能なすべてのサブタイプからランダムに選択することもできます。例: directional。値とそのエフェクトの完全なリストについては、「トランジションエフェクトの例」をご参照ください。 |
Duration | Float | いいえ | トランジションエフェクトの期間 (秒単位)。値は小数点以下 4 桁まで正確です。デフォルト値は 1 秒です。 |
エフェクトタイプ: VFX
タイムラインの例: VFX エフェクト
名前 | タイプ | 必須 | 説明 |
SubType | String | はい | VFX サブタイプ。コンマで区切って複数のサブタイプを指定でき、その中から 1 つがランダムに選択されます。また、`random` を指定して、利用可能なすべてのサブタイプからランダムに選択することもできます。例: colorfulradial。値とそのエフェクトの完全なリストについては、「VFX エフェクトの例」をご参照ください。 |
X | Float | いいえ | このフィールドは、SubType が mosaic_rect または blur に設定されている場合にのみサポートされます。エフェクトエリアの左上隅から出力ビデオの左上隅までの水平距離。 注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。 |
Y | Float | いいえ | このフィールドは、SubType が mosaic_rect または blur に設定されている場合にのみサポートされます。 エフェクトエリアから出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。 |
Width | Float | いいえ | このフィールドは、SubType が mosaic_rect または blur に設定されている場合にのみサポートされます。出力ビデオ内のエフェクトエリアの幅。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。 |
Height | Float | いいえ | このフィールドは、SubType が mosaic_rect または blur に設定されている場合にのみサポートされます。出力ビデオ内のエフェクトエリアの高さ。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。 |
ExtParams | String | いいえ | エフェクトの拡張パラメーター。このフィールドは、SubType が mask_circle、mask_rec、mask_linear、または mask_minor に設定されているマスキングシナリオでのみ有効になります。マスキングの ExtParams 構成については、次のセクションをご参照ください。 |
マスキングとその結果のエフェクトの例については、「マスキングエフェクト」をご参照ください。
以下のマスキングパラメーターについて、パラメーターが浮動小数点数の場合は、0.5 や 2.0 などの浮動小数点形式で指定する必要があります。
円形マスクエフェクトのパラメーター
SubType=mask_circle
ExtParams パラメーター
パラメータ | タイプ | 値の範囲 | デフォルト値 | 説明 |
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 | 回転角度。 |
矩形マスクエフェクトのパラメーター
SubType=mask_rec
ExtParams パラメーター
パラメータ | タイプ | 値の範囲 | デフォルト値 | 説明 |
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 | 回転角度。 |
線形マスクエフェクトのパラメーター
SubType=mask_linear
ExtParams パラメーター
パラメータ | タイプ | 値の範囲 | デフォルト値 | 説明 |
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 | 回転角度。 |
ミラーマスクエフェクトのパラメーター
SubType=mask_minor
ExtParams パラメーター
パラメータ | タイプ | 値の範囲 | デフォルト値 | 説明 |
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 | 回転角度。 |
エフェクトタイプ: フィルター
タイムラインの例: フィルターエフェクト
名前 | タイプ | 必須 | 説明 |
SubType | String | はい | フィルターのサブタイプ。コンマで区切って複数のサブタイプを指定でき、その中から 1 つがランダムに選択されます。また、`random` を指定して、利用可能なすべてのサブタイプからランダムに選択することもできます。例: M1。値とそのエフェクトの完全なリストについては、「フィルターエフェクトの例」をご参照ください。 |
TimelineIn | Float | いいえ | タイムライン上のフィルターの開始時間 (秒単位)。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、値は対応するクリップの TimelineIn と同じになります。 |
TimelineOut | Float | いいえ | タイムライン上のフィルターの終了時間 (秒単位)。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、値は対応するクリップの TimelineOut と同じになります。 |
ExtParams | String | いいえ | フィルターの拡張パラメーター。このフィールドは、SubType が color (カラーフィルター) に設定されている場合にのみ有効になります。カラーフィルターの ExtParams 構成については、次のセクションをご参照ください。 |
カラーフィルターの ExtParams
タイムラインの例: カラーフィルターを使用する
ExtParams パラメーター
パラメータ | タイプ | 値の範囲 | 説明 | デフォルト値 |
brightness | int | [-255,255] | 輝度 | 0 |
contrast | int | [-100,100] | コントラスト | 0 |
saturation | int | [-100,100] | 彩度 | 0 |
kelvin_temperature | int | [1000,40000] | 温度。このパラメーターは temperature_ratio パラメーターと連動して有効になります。 | 6000 |
temperature_ratio | int | [0,100] | 温度比 | 0 |
tint | int | [-100,100] | 色合い | 0 |
dark_corner_ratio | int | [0,100] | ダークコーナー比 | 0 |
エフェクトタイプ: ボリューム
タイムラインの例: ビデオ全体をミュートする、ビデオとオーディオのボリュームを調整する
名前 | タイプ | 必須 | 説明 |
Gain | Float | はい | ボリュームゲイン。値の範囲は 0 から 10 です。値が小さいほどボリュームが低くなります。値が 0 の場合はオーディオをミュートします。値が 1 の場合は元のボリュームを維持します。値が 1 未満の場合はボリュームを下げます。値が 1 より大きい場合はボリュームを上げます。オーディオの歪みを避けるため、ゲインを高く設定しすぎないでください。 |
エフェクトタイプ: AFade (オーディオフェードイン/フェードアウト)
タイムラインの例: オーディオのみのクリップとビデオクリップ内のオーディオのフェードイン/フェードアウトを構成する
名前 | タイプ | 必須 | 説明 |
SubType | String | はい | オーディオのフェードイン/フェードアウトのサブタイプ。有効な値:
|
Duration | Float | いいえ | フェードインまたはフェードアウトエフェクトの期間。フェードインエフェクトは素材セグメントの開始時に適用されます。フェードアウトエフェクトは素材セグメントの終了時に適用されます。デフォルト値は 0 で、エフェクトが無効であることを意味します。 |
Curve | String | いいえ | フェードイン/フェードアウトエフェクトのボリュームカーブ。デフォルト値は exp です。 有効な値:
|
エフェクトタイプ: AI_ASR (音声テキスト変換)
このエフェクトは、オーディオから字幕を生成します。このエフェクトは、ビデオまたはオーディオトラックの Effects オブジェクトに追加できます。パラメーターは、「エフェクトタイプ: テキスト (バナーテキスト)」のパラメーターと同じです。デフォルトでは、字幕はビデオの下部中央に配置されます。この機能は、中国 (北京)、中国 (上海)、および中国 (杭州) リージョンでのみ利用できます。
名前 | タイプ | 必須 | 説明 |
X | Float | いいえ | バナーテキストの左上隅から出力ビデオの左上隅までの水平距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの幅のパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。 |
Y | Float | いいえ | バナーテキストの左上隅から出力ビデオの左上隅までの垂直距離。注: パーセンテージとピクセル値の両方がサポートされています。0 から 0.9999 までの値は、出力ビデオの高さのパーセンテージを表します。2 以上の整数は、絶対ピクセル値を表します。 |
Font | String | いいえ | バナーテキストのフォント。サポートされているフォントのリストについては、「フォントリスト」をご参照ください。デフォルトのフォントは SimSun です。 |
FontSize | Int | はい | バナーテキストのフォントサイズ。 |
FontColor | String | いいえ | テロップテキストの色。フォーマットは、シャープ記号 (#) の後に 16 進数が続く形式です。例: #ffffff。 |
FontColorOpacity | String | いいえ | テロップテキストの不透明度。値の範囲は 0 から 1 です。値 1 はテキストが不透明であることを意味します。値 0 はテキストが完全に透明であることを意味します。デフォルト値は 1 です。 |
FontFace | FontFace | いいえ | バナーテキストのフォントフェイス。 |
NeedHighlighting | Boolean | いいえ | ASR 字幕の自動ハイライトを有効にするかどうかを指定します。 |
HighlightingStyle | いいえ | ハイライトされた字幕のスタイル。 |
エフェクトタイプ: Rotate (素材の回転)
このエフェクトは、指定された角度で素材を回転させます。90°、180°、270° の回転のみがサポートされています。このエフェクトは、ビデオトラック上のビデオまたはイメージ素材の Effects オブジェクトに追加できます。
タイムラインの例: 素材の回転
名前 | タイプ | 必須 | 説明 |
Degree | Integer | はい | 素材の時計回りの回転角度。90、180、270 のみがサポートされています。 |
エフェクトタイプ: AI_Matting (イメージマット)
このエフェクトは、グリーンまたはブルーのスクリーンバックグラウンドからオブジェクトを抽出し、別のバックグラウンドビデオまたはイメージに重ね合わせます。この機能は、中国 (北京)、中国 (上海)、および中国 (杭州) リージョンでのみ利用できます。
名前 | タイプ | 必須 | 説明 |
Color | String | はい | バックグラウンドカラー。グリーン (グリーンバックキーイング) とブルー (ブルーバックキーイング) のみがサポートされています。 |
Auto | Integer | はい | 背景色を自動的に検出するかどうかを指定します。有効な値:
|
Thres | Float | いいえ | バックグラウンドカラー検出のしきい値。値が大きいほど、検出が緩やかになります。値の範囲は 0 から 10 です。 |
エフェクトタイプ: AI_RealMatting (リアルシーンマット)
このエフェクトは、ビデオ内の実世界のシーンから人物を抽出し、別のバックグラウンドビデオまたはイメージに重ね合わせます。この機能は、中国 (北京)、中国 (上海)、および中国 (杭州) リージョンでのみ利用できます。
名前 | タイプ | 必須 | 説明 |
Thres | Float | いいえ | バックグラウンドカラー検出のしきい値。値が大きいほど、検出が緩やかになります。値の範囲は 0 から 10 です。デフォルト値は 2 です。 |
エフェクトタイプ: AI_Delogo (インテリジェントロゴ除去)
このエフェクトは、ビデオから放送局のロゴをインテリジェントに認識して削除します。この機能は、中国 (北京) および中国 (上海) リージョンでのみ利用できます。
エフェクトタイプ: Clip (ランダムクリッピング)
このエフェクトは、クリッピング機能を提供します。現在、ランダムクリッピングのみがサポートされています。元の素材からランダムな期間のセグメントがクリップされ、タイムラインに追加されます。
名前 | 種類 | 必須 | 説明 |
SubType | String | はい | クリッピングタイプ。現在、ランダムクリッピングのみがサポートされています: RandomClip。 |
ClipDuration | Float | はい | クリップされたセグメントのデュレーション。 |
エフェクトタイプ: 反転
このエフェクトは、ビデオトラック上のビデオまたはイメージのフレームを水平または垂直に反転させます。
タイムラインの例: 水平反転と垂直反転
名前 | 種類 | 必須 | 説明 |
Direction | String | はい |
|
エフェクトタイプ: KenBurns (パンとズーム)
このエフェクトは、ビデオトラック上のビデオまたはイメージにパンとズームのエフェクトを適用します。
制限:
このエフェクトは、イメージとビデオに適用されます。VFX、フィルター、トランジションエフェクトと併用できます。
このエフェクトでは、出力フレームの幅と高さを設定できます (以下の WindowW/WindowH パラメーターを参照)。したがって、トリミング、スケール、Pad、またはバックグラウンドエフェクトと併用することはできません。
名前 | タイプ | 必須 | 説明 | 例 | |
Duration | Float | いいえ | エフェクトの期間 (秒単位)。デフォルト値はクリップの期間です。最大値は 10 です。 | 5 | |
WindowW | Float | いいえ | 最終出力セグメントの幅 (ピクセル単位)。デフォルト値は出力ビデオの幅です。 開閉区間 (0, 1] の値は相対値を表します。1 より大きい値は絶対値を表します。 | 1 | |
WindowH | Float | いいえ | 最終出力セグメントの高さ (ピクセル単位)。デフォルト値は出力ビデオの高さです。 開閉区間 (0, 1] の値は相対値を表します。 > 1 は絶対値を表します。 | 1 | |
Start | String | いいえ | エフェクト開始時の元の素材におけるフレームの左上隅の位置 (x 座標、y 座標、幅、高さ)。値はコンマで区切られます。すべての値はオプションです。 "StartX,StartY,StartW,StartH" 制限: 0 < StartX + StartW <=1 0 < StartY + StartH <=1 | "0,0,0.9,0.9" | |
StartX | Float | いいえ | エフェクト開始時の元の素材におけるフレームの左上隅の x 座標 (ピクセル単位)。 閉開区間 [0, 1) の値は相対値を表します。 1 以上の値は絶対値を表します。 | 0 | |
StartY | Float | いいえ | エフェクト開始時の元の素材におけるフレームの左上隅の y 座標 (ピクセル単位)。 閉開区間 [0, 1) の値は相対値を表します。 1 以上の値は絶対値を表します。 | 0 | |
StartW | Float | いいえ | エフェクト開始時の元の素材におけるフレームの幅 (ピクセル単位)。 開閉区間 (0, 1] の値は相対値を表します。 1 より大きい値は絶対値を表します。 | 0.9 | |
StartH | Float | いいえ | エフェクト開始時の元の素材におけるフレームの高さ (ピクセル単位)。 開閉区間 (0, 1] の値は相対値を表します。 > 1 は絶対値を示します。 | 0.9 | |
End | String | いいえ | エフェクト終了時の元の素材におけるフレームの左上隅の位置 (x 座標、y 座標、幅、高さ)。値はコンマで区切られます。すべての値はオプションです。 "EndX,EndY,EndW,EndH" 制限: 0 < EndX + EndW <=1 0 < EndY + EndH <=1 | "0,0,1,1" | |
EndX | Float | いいえ | エフェクト終了時の元の素材におけるフレームの左上隅の x 座標 (ピクセル単位)。 閉開区間 [0, 1) の値は相対値を表します。 1 以上の値は絶対値を表します。 | 0 | |
EndY | Float | いいえ | エフェクト終了時の元の素材におけるフレームの左上隅の y 座標 (ピクセル単位)。 閉開区間 [0, 1) の値は相対値を表します。 1 以上の値は絶対値を表します。 | 0 | |
EndW | Float | いいえ | エフェクト終了時の元の素材におけるフレームの幅 (ピクセル単位)。 開閉区間 (0, 1] の値は相対値を表します。 > 1 は絶対値を表します。 | 1 | |
EndH | Float | いいえ | エフェクト終了時の元の素材におけるフレームの高さ (ピクセル単位)。 開閉区間 (0, 1] の値は相対値を表します。 > 1 の値は絶対値を示します。 | 1 | |
エフェクトタイプ: ADenoise (オーディオノイズ除去)
このエフェクトは、ビデオトラック上のビデオ内のオーディオ、またはオーディオトラック上のオーディオクリップに対してノイズ除去を実行します。
名前 | 種類 | 必須 | 説明 |
Mode | Integer | いいえ |
|
エフェクトタイプ: ズーム
このエフェクトは、対応するクリップにズームエフェクトを追加します。
このエフェクトは、VideoTrack 上のクリップにのみ使用できます。
名前 | 種類 | 必須 | 説明 |
StartRate | Float | いいえ |
|
EndRate | Float | いいえ |
|
Duration | Float | いいえ |
|
エフェクトタイプ: Harmonization (バックグラウンドブレンド)
このエフェクトは、対応するクリップにバックグラウンドブレンドエフェクトを追加します。このエフェクトは、主にデジタルヒューマンビデオクリップに使用されます。このエフェクトをデジタルヒューマンビデオクリップに追加すると、バックグラウンドイメージの照明、輝度、色温度に適応し、デジタルヒューマンビデオクリップとバックグラウンドイメージの間のよりシームレスなブレンドを作成します。
このエフェクトは、VideoTrack 上のクリップにのみ使用できます。
1 回のビデオ編集リクエストで追加できる Harmonization エフェクトは 1 つだけです。
このエフェクトには他の入力パラメーターはありません。
エフェクトタイプ: ALoudNorm (ラウドネス正規化)
ALoudNorm は、単一のオーディオまたはビデオ素材にのみ適用されます。複数のオーディオまたはビデオ素材があり、それらを同じラウドネスにしたい場合は、各素材に個別に ALoudNorm を構成する必要があります。
このエフェクトは、オーディオおよびビデオクリップにのみ適用されます。ALoudNorm が ADenoise または Volume と一緒に使用される場合、適用順序は ADenoise > Volume > ALoudNorm です。
タイムラインの例: ラウドネス正規化
名前 | タイプ | 必須 | 説明 |
Loudness | Float | いいえ | ターゲットラウドネス。ボリュームレベルを決定し、EBU R 128 規格に準拠します。値の範囲は -70.0 から -5.0 です。デフォルト値は -24.0 です。 |
TruePeak | Float | いいえ | トゥルーピークレベル。オーディオ信号の最高ピークレベルを制限します。値の範囲は -9.0 から +0.0 です。デフォルト値は -2.0 です。 |
エフェクトタイプ: AEqualize (オーディオイコライゼーション)
このエフェクトは、グローバルエフェクトとしてエフェクトトラックに適用されます。プロジェクト全体のオーディオに均一なオーディオイコライゼーションを実行します。
このエフェクトはグローバルにのみ適用され、個々のクリップにはサポートされていません。
タイムラインの例: オーディオイコライゼーション
名前 | タイプ | 必須 | 説明 |
Peak | Float | いいえ | オーディオのターゲットピークレベル。デフォルト値は 0.95 です。この値を超えないことをお勧めします。 値は開区間 (0, 1) 内である必要があります。 |
Gain | Float | いいえ | 最大ゲイン係数。値の範囲は 1.0 から 100.0 です。デフォルト値は 10.0 です。 動的オーディオノーマライザーは、クリッピングや歪みを引き起こさない各入力フレームの最大可能 (ローカル) ゲイン係数を決定します。 |
エフェクトタイプ: FreezeFrame (フリーズフレーム)
このエフェクトは、ビデオトラック上のビデオ素材に適用されます。ビデオの最後のフレームをフリーズさせます。
このエフェクトは、ビデオトラック上のビデオ素材にのみ適用されます。ビデオトラック上のイメージ素材やオーディオトラック上の素材には適用されません。
エフェクトタイプ: トランジションエフェクトと併用することはできません。
タイムラインの例: ビデオのフリーズフレーム
名前 | タイプ | 必須 | 説明 |
Duration | Float | いいえ | フリーズフレームの期間 (秒単位)。デフォルト値は 0 です。 |