Intelligent Media Services:エフェクトの設定

名前

型

必須

説明

X

Float

いいえ

バナーテキストの左上隅と出力ビデオの左上隅との間の水平距離。パーセンテージ形式とピクセル形式の両方がサポートされています。[0, 0.9999] の範囲の値は、出力ビデオの幅に対する比率を指定します。2 以上の整数値は絶対ピクセルを指定します。デフォルト値： 0。この座標は、クリップサイズと出力ビデオサイズに基づいてスケーリングされます。

Y

Float

いいえ

バナーテキストの左上隅と出力ビデオの左上隅との間の垂直距離。パーセンテージ形式とピクセル形式の両方がサポートされています。[0, 0.9999] の範囲の値は、出力ビデオの高さに対する比率を指定します。2 以上の整数値は絶対ピクセルを指定します。デフォルト値： 0。この座標は、クリップサイズと出力ビデオサイズに基づいてスケーリングされます。

FixedX

Float

いいえ

バナーテキストの左上隅と出力ビデオの左上隅との間の水平距離。パーセンテージ形式とピクセル形式の両方がサポートされています。[0, 0.9999] の範囲の値は、出力ビデオの幅に対する比率を指定します。2 以上の整数値は絶対ピクセルを指定します。デフォルト値： 0。この座標は、クリップサイズと出力ビデオサイズに基づいてスケーリングされません。

FixedY

Float

いいえ

バナーテキストの左上隅と出力ビデオの左上隅との間の垂直距離。パーセンテージ形式とピクセル形式の両方がサポートされています。[0, 0.9999] の範囲の値は、出力ビデオの高さに対する比率を指定します。2 以上の整数値は絶対ピクセルを指定します。デフォルト値： 0。この座標は、クリップサイズと出力ビデオサイズに基づいてスケーリングされません。

TimelineIn

Float

いいえ

タイムライン上のバナーテキストの開始位置。単位：秒、小数点以下 4 桁まで有効。このパラメーターを空のままにした場合、値は対応するクリップの TimelineIn 値と同じになります。

TimelineOut

Float

いいえ

タイムライン上のバナーテキストの終了位置。単位：秒、小数点以下 4 桁まで有効。このパラメーターを空のままにした場合、値は対応するクリップの TimelineOut 値と同じになります。

名前

型

必須

説明

Content

String

はい

バナーテキストのコンテンツ。

Font

String

いいえ

バナーテキストのフォント。サポートされているフォントについては、「フォントリスト」をご参照ください。デフォルト値： SimSun。

FontSize

Int

はい

バナーテキストのフォントサイズ。このフォントサイズは、クリップサイズと出力ビデオサイズに基づいてスケーリングされます。デフォルト値： 0。最大値： 5000。FontSize と FixedFontSize のいずれか一方のみを指定します。両方を指定した場合、FontSize のみが有効になります。

FixedFontSize

Int

はい

バナーテキストのフォントサイズ。このフォントサイズは、クリップサイズと出力ビデオサイズに基づいてスケーリングされません。FontSize と FixedFontSize のいずれか一方のみを指定します。両方を指定した場合、FontSize のみが有効になります。

SizeRequestType

String

いいえ

フォントサイズから実際にレンダリングされるテキストサイズを計算するために使用されるメソッド。デフォルト値： RealDim。有効な値： Nominal：レンダリングされた字幕の高さ (ピクセル単位) は FontSize の値と等しくなります。RealDim：一部のフォントでは、レンダリングされた字幕の高さ (ピクセル単位) が FontSize の値より小さくなる場合があります。

FontUrl

String

いいえ

ご利用の OSS バケット内のカスタムフォントファイルへのパス。TTF、OTF、および WOFF 形式がサポートされています。例： https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf

名前

型

必須

説明

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。

Outline

Int

いいえ

バナーテキストのアウトラインの幅。単位：ピクセル。デフォルト値： 0。

OutlineColour

String

いいえ

バナーテキストのアウトラインの色。シャープ記号 (#) の後に 16 進数値を続けた形式で指定します。例： #ffffff。

Shadow

Int

いいえ

バナーテキストによって投影される影の深さ。単位：ピクセル。デフォルト値： 0。

BackColour

String

いいえ

バナーテキストの影の色。シャープ記号 (#) の後に 16 進数値を続けた形式で指定します。例： #ffffff。

名前

型

必須

説明

Alignment

String

いいえ

バナーテキストの配置と整列モード。デフォルト値： TopLeft。このパラメーターには 2 つの側面があります： 位置アンカー — ビデオ上のテキストの配置場所を決定します。有効な値： TopLeft (左上隅)、TopCenter (垂直中央線の上部)、TopRight (右上隅)、CenterLeft (水平中央線の左側)、CenterCenter (ビデオの中央)、CenterRight (水平中央線の右側)、BottomLeft (左下隅)、BottomCenter (垂直中央線の下部)、BottomRight (右下隅)。テキスト配置モード — X 座標と Y 座標が字幕テキストにどのようにマッピングされるかを決定します。正確な配置のためには、次のいずれかのモードを使用します： Left (左揃え。X と Y は、ビデオの左上隅を基準とした字幕の左上頂点の座標を指定します)、Center (中央揃え。X と Y は、ビデオの左上隅を基準とした字幕中央線の上境界線上の交点の座標を指定します)、Right (右揃え。X と Y は、ビデオの左上隅を基準とした字幕の右上頂点の座標を指定します)。

AdaptMode

String

いいえ

バナーテキストがビデオの幅または指定された TextWidth 値を超えた場合に、自動的に折り返すかスケーリングするかを指定します。有効な値： AutoWrap (自動改行)、AutoScale (自動スケーリング)、AutoWrapAtSpaces (スペースでのみ自動改行、英語のみの字幕に適用)。

TextWidth

String

いいえ

字幕テキストボックスの幅。このパラメーターは AdaptMode が指定されている場合に有効になります。改行またはスケーリングは、このテキストボックスの幅に基づいて実行されます。このパラメーターを空のままにした場合、改行またはスケーリングはビデオの幅に基づいて実行されます。0 より大きく 1 以下の値は、出力ビデオに対する相対的な幅を指定します。1 より大きい値は絶対ピクセルを指定します。

EnableLocalStyleAutoScale

Boolean

いいえ

ローカル字幕スタイルのフォントサイズ、アウトラインサイズ、および影のサイズを出力ビデオサイズと FECanvas サイズに基づいてスケーリングするかどうかを指定します。デフォルト値： false。

SupportBidi

Boolean

いいえ

双方向テキストレンダリングを有効にするかどうかを指定します。字幕テキストに英語、数字、ラテン文字などの左から右 (LTR) のテキストと、右から左 (RTL) のテキストの両方が含まれる場合にこの機能を有効にします。デフォルト値： false。

名前

型

必須

説明

EffectColorStyle

String

いいえ

バナーテキストのアート文字スタイルタイプ。詳細については、「ワードアート」をご参照ください。

TextureURL

String

いいえ

字幕のテクスチャ効果。PNG、JPG、JPEG、および BMP 形式がサポートされています。OSS ファイルのみがサポートされています。例： https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png

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 未満の値はループの減速を示します。

SubtitleEffects

SubtitleEffect[]

いいえ

バナーテキストのマルチレイヤーエフェクト。マルチレイヤーアウトライン、マルチレイヤーシャドウ、ガウスぼかし (タイプがシャドウの場合のみサポート)、および字幕背景エフェクトがサポートされています。SubtitleEffects を指定した場合、字幕トラックの Outline および Shadow フィールドは有効にならなくなります。マルチレイヤーアウトライン、シャドウ、または背景エフェクトを設定する場合、SubtitleEffects 配列の順序がレイヤーの順序を指定します。配列の最初の SubtitleEffect は最下層にレンダリングされ、配列の最後の SubtitleEffect は最上層にレンダリングされます。

名前

型

必須

説明

BubbleStyleId

String

いいえ

バブルテキストのスタイルタイプ。バブルのタイプと効果については、「テキストバブル効果の例」をご参照ください。

BubbleWidth

Float

いいえ

出力ビデオに対するバブル背景イメージの幅。このパラメーターはバブルテキストを使用する場合にのみ有効です。1 より大きい値は絶対ピクセルを指定します。1 以下の値は相対値を指定します。

BubbleHeight

Float

いいえ

出力ビデオに対するバブル背景イメージの高さ。このパラメーターはバブルテキストを使用する場合にのみ有効です。1 より大きい値は絶対ピクセルを指定します。1 以下の値は相対値を指定します。

パラメーター

型

有効な値

デフォルト値

説明

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

回転角度。

blur_intensity

float

[0.0, 1.0]

0

マスク内のぼかしの強度。値 0.0 はぼかしを無効にします。値が大きいほど、マスク領域のぼかしの度合いが高くなります。

outer_alpha

float

[0.0, 1.0]

0

マスク外の領域の不透明度。値 0.0 は、マスク外の領域が完全に透明であることを示します。値 1.0 は、マスク外の元のイメージが完全に保持されることを示します。中間の値は、半透明の保持を示します。

パラメーター

型

有効な値

デフォルト値

説明

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

回転角度。

blur_intensity

float

[0.0, 1.0]

0

マスク内のぼかしの強度。値 0.0 はぼかしを無効にします。値が大きいほど、マスク領域のぼかしの度合いが高くなります。

outer_alpha

float

[0.0, 1.0]

0

マスク外の領域の不透明度。値 0.0 は、マスク外の領域が完全に透明であることを示します。値 1.0 は、マスク外の元のイメージが完全に保持されることを示します。中間の値は、半透明の保持を示します。

パラメーター

型

有効な値

デフォルト値

説明

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

回転角度。

blur_intensity

float

[0.0, 1.0]

0

マスク内のぼかしの強度。値 0.0 はぼかしを無効にします。値が大きいほど、マスク領域のぼかしの度合いが高くなります。

outer_alpha

float

[0.0, 1.0]

0

マスク外の領域の不透明度。値 0.0 は、マスク外の領域が完全に透明であることを示します。値 1.0 は、マスク外の元のイメージが完全に保持されることを示します。中間の値は、半透明の保持を示します。

パラメーター

型

有効な値

デフォルト値

説明

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

回転角度。

blur_intensity

float

[0.0, 1.0]

0

マスク内のぼかしの強度。値 0.0 はぼかしを無効にします。値が大きいほど、マスク領域のぼかしの度合いが高くなります。

outer_alpha

float

[0.0, 1.0]

0

マスク外の領域の不透明度。値 0.0 は、マスク外の領域が完全に透明であることを示します。値 1.0 は、マスク外の元のイメージが完全に保持されることを示します。中間の値は、半透明の保持を示します。

パラメーター

型

有効な値

デフォルト値

説明

brightness

int

[-255, 255]

0

輝度調整。

contrast

int

[-100, 100]

0

コントラスト調整。

saturation

int

[-100, 100]

0

彩度調整。

kelvin_temperature

int

[1000, 40000]

6000

色温度。temperature_ratio と共に有効になります。

temperature_ratio

int

[0, 100]

0

色温度の比率。

tint

int

[-100, 100]

0

色合い調整。

dark_corner_ratio

int

[0, 100]

0

ビネットの比率。