Intelligent Media Services:タイムライン構成

名前

タイプ

必須

説明

VideoTracks

VideoTrack[]

いいえ。ビデオトラックとオーディオトラックを同時に空にすることはできません。

ビデオトラック。ビデオトラックは、MediaId 配列要素の順序に基づいてオーバーレイされます。たとえば、最初の MediaId 配列要素に対応するトラックは、2 番目の MediaId 配列要素に対応するトラックの下に配置されます。

AudioTracks

AudioTrack[]

いいえ。ビデオトラックとオーディオトラックを同時に空にすることはできません。

オーディオトラック。

ImageTracks（画像トラック機能はビデオトラック機能に統合され、反復または維持されなくなりました。）

ImageTrack[]

いいえ。イメージトラックが存在する場合、ビデオトラックは必須です。

画像トラック。注：

1) イメージトラックはビデオトラックの上に配置する必要があります。画像とビデオの制作シナリオで、画像を素材としてビデオと混合する場合は、ビデオトラックを使用します。

2) イメージトラックは、MediaId 配列要素のシーケンスに基づいてオーバーレイされます。たとえば、最初の MediaId 配列要素に対応するトラックは、2 番目の MediaId 配列要素に対応するトラックの下に配置されます。

SubtitleTracks

SubtitleTrack[]

いいえ

字幕トラック。

EffectTracks

EffectTrack[]

いいえ

エフェクトトラック。

名前

タイプ

必須

説明

Type

String

いいえ

ビデオトラックのタイプ。デフォルトでは、通常のビデオトラックが使用されます。

Type を Effect に設定すると、ビデオトラックをエフェクトに使用できます。この場合、VideoTrackClips で EffectTrackItem オブジェクトを指定できます。

MainTrack

Boolean

いいえ

現在のビデオトラックがプライマリートラックであるかどうかを指定します。デフォルト値: False。詳細については、「メイン トラックの設定」をご参照ください。

TrackShortenMode

String

いいえ

現在のビデオトラックの時間がメイントラックの時間より長い場合、現在のトラックの時間はメイントラックの時間に合うように適応的に短縮されます。このパラメーターは、トラックが短縮されるモードを指定します。有効値：

• AutoSpeed：ビデオが自動的に加速されます。

TrackExpandMode

String

いいえ

現在のビデオトラックの時間がメイントラックの時間より短い場合、現在のトラックの時間はメイントラックの時間に合うように適応的に延長されます。このパラメーターは、トラックが延長されるモードを指定します。有効値：

• AutoSpeed：ビデオが自動的に減速されます。

VideoTrackClips

VideoTrackClip[]

はい

ビデオクリップ。

名前

タイプ

必須

説明

MainTrack

Boolean

いいえ

現在のオーディオトラックがプライマリートラックであるかどうかを指定します。デフォルト値: False。詳細については、「メイン トラックの設定」をご参照ください。

TrackShortenMode

String

いいえ

現在のオーディオトラックの時間がメイントラックの時間より長い場合、現在のトラックの時間はメイントラックの時間に合うように適応的に短縮されます。このパラメーターは、トラックが短縮されるモードを指定します。有効値：

• AutoSpeed：オーディオが自動的に加速されます。

TrackExpandMode

String

いいえ

現在のオーディオトラックの時間がメイントラックの時間より短い場合、現在のトラックの時間はメイントラックの時間に合うように適応的に延長されます。このパラメーターは、トラックが延長されるモードを指定します。有効値：

• AutoSpeed：オーディオが自動的に減速されます。

AudioTrackClips

AudioTrackClip[]

はい

オーディオトラックの素材。

名前

タイプ

必須

説明

ImageTrackClips （画像トラック機能はビデオトラック機能に統合され、反復または維持されなくなりました。）

ImageTrackClip[]

はい

画像トラックの素材。

名前

タイプ

必須

説明

SubtitleTrackClips

SubtitleTrackClip[]

はい

字幕トラックの素材。

名前

タイプ

必須

説明

備考

Type

String

はい

現在のクリップのタイプ

• 値を AI_Avatar に設定します。

MediaId

String

いいえ

デジタルヒューマンのレンダリングに使用する音声の ID。

• MediaId、MediaURL、および Content のいずれか 1 つのみを指定する必要があります。

MediaURL

String

いいえ

デジタルヒューマンのレンダリングに使用する音声ファイルの URL。

• MediaId、MediaURL、および Content のいずれか 1 つのみを指定する必要があります。

• このパラメーターには、インターネット経由でアクセスできるパブリック OSS URL またはパブリック URL を指定できます。

Content

String

いいえ

デジタルヒューマンのレンダリングに使用するテキストコンテンツ。

• MediaId、MediaURL、および Content のいずれか 1 つのみを指定する必要があります。

• このパラメーターの値には、5 文字以上を含める必要があります。

AvatarId

String

いいえ

デジタルヒューマン画像の ID。

• 詳細については、「デジタルヒューマンイメージの例」をご参照ください

Voice

String

いいえ

音声のタイプ。

• このパラメーターは、Content を指定した場合に有効になります。

• 音声エフェクトについては、「インテリジェント音声サンプル」をご参照ください。

CustomizedVoice

String

いいえ

パーソナライズされた人間の音声。

• 人間の音声クローニング機能を使用してトレーニングされた音声の ID を指定します。パーソナライズされた人間の音声を使用してオーディオを生成できます。

• このパラメーターを指定すると、Voice は無効になります。

LoopMotion

ブール値

いいえ

最初と最後のフレームが同一

• このパラメーターを true に設定すると、デジタルヒューマン用に生成されたビデオの最初と最後のフレームが同じになります。これにより、ループ再生中またはデジタルヒューマンビデオがマージされたときに、デジタルヒューマンの動きと表情のフレームジャンプが防止されます。

• 有効な値: {true, false}

• デフォルト値: false

SpeechRate

Integer

いいえ

話すテンポ。

• このパラメーターは、Content を指定した場合に有効になります。有効な値: [-500, 500]。デフォルト値: 0。

  • -500 の値は、話すテンポが元のテンポの 0.5 倍であることを示します。0 の値は、元のテンポが使用されることを示します。500 の値は、話すテンポが元のテンポの 2 倍であることを示します。

PitchRate

Integer

いいえ

イントネーション。

• このパラメーターは、Content を指定した場合に有効になります。

• 有効な値: [-500, 500]

• デフォルト値: 0

名前

タイプ

必須

説明

MediaId

String

いいえ

イメージトラック内の素材が対応する IMS または VOD メディアアセットの ID。

注: MediaId と MediaURL のいずれか 1 つのみを指定する必要があります。

MediaURL

String

いいえ

イメージトラック内の素材の OSS URL。OSS URL のフォーマットは次のとおりです: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.mp4

注:

• MediaId と MediaURL のいずれか 1 つのみを指定する必要があります。

• このパラメーターには、パブリック OSS URL のみを指定できます。

X

Float

いいえ

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

Y

Float

いいえ

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

Width

Float

いいえ

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

Height

Float

いいえ

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

TimelineIn

Float

いいえ

タイムライン内のイメージの開始時刻。単位: 秒。値は小数点以下 4 桁まで正確です。TimelineIn を指定しない場合、デフォルトで 0 が使用されます。

TimelineOut

Float

いいえ

タイムラインにおけるイメージの終了時間です。単位: 秒。値は小数点以下 4 桁まで正確です。 TimelineOut を指定しない場合は、ビデオトラックの最大時間が使用されます。

DyncFrames

Int

いいえ

アニメーションステッカーのフレーム数。このパラメーターは、ソースファイルがアニメーションイメージの場合に必須です。詳細については、「GIF ステッカーの追加」をご参照ください。

Effects

エフェクト[]

いいえ

マテリアルに使用されるエフェクトです。

名前

タイプ

必須

説明

Type

String

はい

字幕素材のタイプ。有効値：

• Subtitle: 外部字幕ファイル

• Text: バナーテキスト

SubType

String

いいえ

字幕素材のサブタイプ。有効値：

• srt: SubRip Subtitle（SRT）形式の外部字幕ファイル

• ass: Advanced SubStation Alpha（ASS）形式の外部字幕ファイル

Type を Text に設定した場合は、このパラメーターを無視します。

FileURL

String

いいえ

字幕ファイルの OSS URL。 Type を Subtitle に設定した場合は、このパラメーターが必須です。OSS URL は次の形式です。

https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt

注記：

• このパラメーターには、パブリック OSS URL またはインターネット経由でアクセスできるパブリック URL を指定できます。

例: 外部字幕

X

Float

いいえ

バナーテキストの左上隅と出力ビデオの左上隅の間の水平方向の距離。このパラメーターは、Type を Text に設定した場合に有効になります。値はパーセンテージまたはピクセル数で設定できます。値が 0 ～ 0.9999 の範囲内にある場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

Y

Float

いいえ

バナーテキストの左上隅と出力ビデオの左上隅の間の垂直方向の距離。このパラメーターは、Type を Text に設定した場合に有効になります。値はパーセンテージまたはピクセル数で設定できます。値が 0 ～ 0.9999 の範囲内にある場合、値はパーセンテージを示します。値が 2 以上の整数の場合、値はピクセル数を示します。

TimelineIn

Float

いいえ

タイムライン内のバナーテキストの開始時刻。このパラメーターは、Type を Text に設定した場合に有効になります。単位: 秒。値は小数点以下 4 桁まで正確です。TimelineIn を指定しない場合、素材はタイムライン内の前の素材の表示が終了したときに表示されます。

TimelineOut

Float

いいえ

タイムラインにおけるバナーテキストの終了時間。このパラメーターは、Type を Text に設定した場合に有効になります。単位：秒。値は小数点以下 4 桁まで正確です。TimelineOut を指定しない場合、素材はタイムラインの次の素材の表示が開始されたときに表示終了されます。

ClipId

String

いいえ

トラックアライメント値。他のオーディオ、ビデオ、または字幕トラックの素材に同じ ReferenceClipId の値が設定されている場合、他のトラックの素材のタイムライン上の開始時刻と終了時刻は、現在の素材の開始時刻と終了時刻に合わせられます。

• 現在のクリップに TimelineIn と TimelineOut を指定するか、適応スクロールデュレーションを有効にする必要があります。

ReferenceClipId

String

いいえ

トラックアライメント値。他のオーディオ、ビデオ、または字幕トラックの素材に同じ ClipId の値が設定されている場合、現在の素材のタイムライン上の開始時刻と終了時刻は、他のトラックの素材の開始時刻と終了時刻に合わせられます。

Content

String

いいえ

バナーテキスト。 Type を Text に設定した場合は、このパラメーターが必須です。

Font

String

いいえ

バナーテキストのフォント。このパラメーターは、Type を Text に設定した場合に有効になります。デフォルト値: SimSun。サポートされているフォントの詳細については、「フォント」をご参照ください。

FontSize

Int

いいえ

バナーテキストのフォントサイズ。このパラメーターは、Type を Text に設定した場合に有効になります。デフォルト値：0。最大値：5000。

SizeRequestType

String

いいえ

バナーテキストのレンダリングされたフォントのサイズの計算方法。このパラメーターは、Type を Text に設定した場合に有効になります。デフォルト値：RealDim。

• Nominal: 字幕のレンダリング高さ（ピクセル単位）はフォントサイズと同じです。

• RealDim: 一部のフォントでは、字幕のレンダリング高さ（ピクセル単位）がフォントサイズよりも小さい場合があります。

FontColor

String

いいえ

バナーテキストの色。このパラメーターは、Type を Text に設定した場合に有効になります。値の形式は、シャープ記号（#）と 16 進数値です。例：#ffffff。

FontColorOpacity

Float

いいえ

バナーテキストの不透明度。このパラメーターは、Type を Text に設定した場合に有効になります。有効値：0 ～ 1。デフォルト値：1。値 1 は、テキストが完全に不透明であることを示します。値 0 は、テキストが完全に透明であることを示します。

FontFace

FontFace

いいえ

フォントの外観。このパラメーターは、Type を Text に設定した場合に有効になります。

Spacing

Int

いいえ

バナーテキストの単語間隔。このパラメーターは、Type を Text に設定した場合に有効になります。単位：ピクセル。デフォルト値：0。

LineSpacing

Int

いいえ

バナーテキストの行間。このパラメーターは、Type を Text に設定した場合に有効になります。単位：ピクセル。デフォルト値：0。

Angle

Float

いいえ

バナーテキストの反時計回りの回転角度。このパラメーターは、Type を Text に設定した場合に有効になります。単位：度。デフォルト値：0。

BorderStyle

Int

いいえ

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

Outline

Int

いいえ

バナーテキストのアウトライン幅。このパラメーターは、Type を Text に設定した場合に有効になります。単位：ピクセル。デフォルト値：0。

OutlineColour

String

いいえ

バナーテキストのアウトラインの色。このパラメーターは、Type を Text に設定した場合に有効になります。値の形式は、シャープ記号（#）と 16 進数値です。例：#ffffff。

Shadow

Int

いいえ

バナーテキストの影のサイズ。このパラメーターは、Type を Text に設定した場合に有効になります。単位：ピクセル。デフォルト値：0。

BackColour

String

いいえ

バナーテキストの影の色。このパラメーターは、Type を Text に設定した場合に有効になります。値の形式は、シャープ記号（#）と 16 進数値です。例：#ffffff。

Alignment

String

いいえ

テキストの配置モード。このパラメーターは、Type を Text に設定した場合に有効になります。デフォルト値：TopLeft。有効値：

• TopLeft: ビデオの左上隅。

• TopCenter: ビデオの垂直軸の上部。

• TopRight: ビデオの右上隅。

• CenterLeft: ビデオの水平中心線の左側のエリア。

• CenterCenter: ビデオの中央位置。

• CenterRight

• BottomLeft

• BottomCenter: ビデオの垂直中心線の下部。

• BottomRight

異なる配置モードで字幕の正確な位置を指定する場合は、次の方法でテキストの配置を設定することをお勧めします。

• 左揃え：X と Y に、ビデオの左上隅を基準とした字幕の左上頂点の座標を指定します。

• 中央揃え：X と Y に、ビデオの左上隅を基準とした字幕の中央軸上の境界線の交点の座標を指定します。

• 右揃え：X と Y に、ビデオの左上隅を基準とした字幕の右上頂点の座標を指定します。

AdaptMode

String

いいえ

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

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

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

• AutoWrapAtSpaces: 自動改行を有効にし、スペースの位置でのみテキストを折り返します。このオプションは英語テキストにのみ適用されます。

• AutoWrapAtSpacesStrict: スペースでの改行の境界に厳密に従い、文字の不均等な分布を回避します。余白の長さに達すると改行が発生します。

TextWidth

Float

いいえ

テキストボックスの幅。このパラメーターは、AdaptMode を指定した場合に有効になります。このパラメーターは、自動改行または自動スケーリングを有効にした場合に使用されます。このパラメーターを指定しない場合、自動改行または自動スケーリングにはビデオ幅が使用されます。値が 0 より大きく 1 以下の場合、値は出力ビデオの幅に対するテキストボックスの幅のパーセンテージを示します。値が 1 より大きい場合、値はピクセル数を示します。

FontUrl

String

いいえ

フォントファイルの OSS URL。このパラメーターは、Type を Text に設定した場合に有効になります。次のフォーマットのフォントファイルがサポートされています: ttf、otf、woff。例: https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf。

EffectColorStyle

String

いいえ

バナーテキストのワードアート効果。このパラメーターは、Type を Text に設定した場合に有効になります。ワードアート効果の詳細については、「ワードアート効果の例」をご参照ください。

SubtitleEffects

SubtitleEffect[]

いいえ

バナーテキストの多層効果。このパラメーターは、Type を Text に設定した場合に有効になります。多層アウトライン、多層シャドウ、ガウスぼかし、字幕背景効果を設定できます。ガウスぼかしは、字幕テキストに影が設定されている場合にのみサポートされます。

注記：

• SubtitleEffects を指定した場合、SubtitleTrackClip の Outline と Shadow は無効になります。

• 多層アウトライン、多層シャドウ、または字幕背景効果を設定した場合、字幕効果は SubtitleEffects 配列要素の順序に基づいて重ねられます。配列の最初の字幕効果に対応するレイヤーは一番下に配置され、配列の最後の字幕効果に対応するレイヤーは一番上に配置されます。

ScrollStartY

Float

いいえ

字幕を上下にスクロールするための開始点の Y 座標値。このパラメーターは、字幕スクロール効果が設定されている場合に有効になります。単位：ピクセル。値が 1 未満の場合、出力ビデオの高さに対する相対的な尺度を表します。

ScrollEndY

Float

いいえ

字幕を上下にスクロールするための終了点の Y 座標値。このパラメーターは、字幕スクロール効果が設定されている場合に有効になります。単位：ピクセル。値が 1 未満の場合、出力ビデオの高さに対する相対的な尺度を表します。

ScrollSpeed

Float

いいえ

字幕を上下にスクロールする速度。このパラメーターは、字幕スクロール効果が設定されている場合に有効になります。単位：ピクセル/秒。

ScrollStartShift

Float

いいえ

開始点に対する垂直スクロール位置のオフセット。このパラメーターは、垂直字幕スクロールが構成されている場合に有効になります。単位: ピクセル。値が 1 未満の場合、出力ビデオの高さに対する相対的なメジャーを表します。

ScrollEndShift

Float

いいえ

終了点に対する垂直スクロール位置のオフセット。このパラメーターは、垂直字幕スクロールが構成されている場合に有効になります。単位: ピクセル。値が 1 未満の場合、出力ビデオの高さに対する相対的なメジャーを表します。

ScrollStartFreeze

Float

いいえ

垂直スクロールの開始点での一時停止時間。このパラメーターは、垂直字幕スクロールが構成されている場合に有効になります。単位: 秒。

ScrollEndFreeze

Float

いいえ

垂直スクロールの終了点での一時停止時間。このパラメーターは、垂直字幕スクロールが構成されている場合に有効になります。単位: 秒。

ScrollDirection

String

いいえ

水平スクロールの方向。このパラメーターは、水平字幕スクロールが構成されている場合に有効になります。有効な値:

• Left: 左にスクロール

• Right: 右にスクロール

ScrollStartX

Float

いいえ

水平スクロールの開始点の x 座標値。このパラメーターは、水平字幕スクロールが構成されている場合に有効になります。単位: ピクセル。値が 1 未満の場合、出力ビデオの高さに対する相対的なメジャーを表します。

ScrollEndX

Float

いいえ

水平スクロールの終了点の x 座標値。このパラメーターは、水平字幕スクロールが構成されている場合に有効になります。単位: ピクセル。値が 1 未満の場合、出力ビデオの高さに対する相対的なメジャーを表します。

ScrollLoop

Boolean

いいえ

水平スクロール効果をループするかどうかを指定します。このパラメーターは、水平字幕スクロールが構成されている場合に有効になります。

AaiMotionInEffect

String

いいえ

バナーテキストの入り口効果。このパラメーターは、Type を Text に設定した場合に有効になります。字幕の入り口効果の詳細については、「字幕効果の例」をご参照ください。

AaiMotionIn

Float

いいえ

バナーテキストの入場効果の持続時間です。このパラメーターは、Type を Text に設定した場合に有効になります。単位：秒。値は小数点以下 4 桁まで正確です。AaiMotionIn を指定しない場合、デフォルトの持続時間である 0.5 秒が使用されます。テキストが表示される時間が 0.5 秒未満の場合、入場効果の持続時間はテキストの合計持続時間から退出効果の持続時間を引いたものになります。

AaiMotionOutEffect

String

いいえ

バナーテキストの出口効果。このパラメーターは、Type を Text に設定した場合に有効になります。字幕の出口効果の詳細については、「字幕効果の例」をご参照ください。

AaiMotionOut

Float

いいえ

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

AaiMotionLoopEffect

String

いいえ

バナーテキストのループ効果。このパラメーターは、Type を Text に設定した場合に有効になります。ループ効果は、入り口効果または出口効果と同時に有効にすることはできません。テキストのループ効果の詳細については、「字幕効果の例」をご参照ください。

比率

フロート

いいえ

バナーテキストのループ効果の速度。このパラメーターは、Type を Text に設定した場合に有効になります。値は小数点以下 4 桁まで正確です。このパラメーターを指定しない場合、デフォルトで 1 が使用されます。1 より大きい値はループ速度が速いことを示し、1 未満の値はループ速度が遅いことを示します。

TextureURL

String

いいえ

バナーテキストのテクスチャの URL。このパラメーターは、Type を Text に設定した場合に有効になります。PNG、JPG、JPEG、または BMP フォーマットの OSS オブジェクトのみがサポートされています。例: https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png

BubbleStyleId

String

いいえ

バナーテキストのバブル効果 ID。このパラメーターは、Type を Text に設定した場合に有効になります。バブル効果の詳細については、「テキストバブルの例」をご参照ください。

バブル幅

フロート

いいえ

出力ビデオに対するバブルベースマップの幅。このパラメーターは、バブル字幕を使用する場合にのみ有効です。 1 より大きい値はピクセル数を示します。 1 以下の値はパーセンテージを示します。

バブルの高さ

浮動小数点

いいえ

出力ビデオを基準としたバブルベースマップの高さです。このパラメーターは、バブル字幕を使用する場合にのみ有効です。 1 より大きい値はピクセル数を示します。 1 以下の値はパーセンテージを示します。

名前

タイプ

必須

説明

Type

String

はい

特殊効果のタイプ。有効な値: VFX および Filter。

SubType

String

はい

特殊効果のサブタイプ。詳細については、以下をご参照ください:

視覚効果のサンプル

フィルター効果のサンプル

TimelineIn

Float

いいえ

タイムライン内の特殊効果の開始時刻。単位: 秒。値は小数点以下 4 桁まで正確です。TimelineIn を指定しない場合、デフォルトで 0 が使用されます。

TimelineOut

Float

いいえ

タイムライン内の特殊効果の終了時刻。単位: 秒。値は小数点以下 4 桁まで正確です。TimelineOut を指定しない場合、エフェクトはビデオの終了時に終了します。

Duration

Float

いいえ

タイムライン内の特殊効果のデュレーション。単位: 秒。値は小数点以下 4 桁まで正確です。Duration を指定しない場合、ビデオのデュレーションが使用されます。

Duration または TimelineOut のいずれかを指定できます。

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 以上の整数の場合、値はピクセル数を示します。

名前

タイプ

必須

説明

Type

String

Yes

-Outline: アウトライン

-Shadow: 影

-Box: 字幕のバックグラウンドボックス

Bord

Float

No

アウトラインまたはシャドウの幅または高さ。1より大きい値はピクセル数を示します。0より大きく1より小さい値は、テキストサイズに対する相対的な幅または高さを示します。

XBord

Float

No

アウトラインまたはシャドウの幅。1より大きい値はピクセル数を示します。0より大きく1より小さい値は、テキストサイズに対する相対的な幅を示します。このパラメーターの優先度は Bord よりも高くなります。

YBord

Float

No

アウトラインまたはシャドウの高さ。1より大きい値はピクセル数を示します。0より大きく1より小さい値は、テキストサイズに対する相対的な高さを示します。このパラメーターの優先度は Bord よりも高くなります。

Shift

Float

No

アウトラインまたはシャドウの水平方向または垂直方向のオフセット。絶対値が 1 より大きい場合はピクセル数を示します。絶対値が 0 より大きく 1 より小さい場合は、テキストサイズに対する相対的なオフセットを示します。このパラメーターには負の数を設定できます。負の数は、上方向または左方向のオフセットを示します。

XShift

Float

No

アウトラインまたはシャドウの水平方向のオフセット。絶対値が 1 より大きい場合はピクセル数を示します。絶対値が 0 より大きく 1 より小さい場合は、テキストサイズに対する相対的な水平方向のオフセットを示します。このパラメーターの優先度は Shift よりも高くなります。

YShift

Float

No

アウトラインまたはシャドウの垂直方向のオフセット。絶対値が 1 より大きい場合はピクセル数を示します。絶対値が 0 より大きく 1 より小さい場合は、テキストサイズに対する相対的な垂直方向のオフセットを示します。このパラメーターの優先度は Shift よりも高くなります。

Color

String

No

RGB カラー。値の形式は、シャープ記号（#）と 16 進数値です。例：#ffffff。

Opacity

String

No

不透明度。値 1 は、字幕が完全に不透明であることを示します。値 0 は、字幕が完全に透明であることを示します。

Blur

Float

No

ガウスぼかしの範囲（ピクセル単位）。このパラメーターは、Type を Shadow に設定した場合にのみ有効になります。このパラメーターを設定すると、字幕のアウトラインが光ります。

Radius

Float

No

テキストの単色背景の角丸半径。このパラメーターは、Type を Box に設定した場合にのみ有効になります。このパラメーターを設定すると、字幕の背景の角が丸くなります。

ImageUrl

String

No

カスタム字幕背景画像の URL。このパラメーターは、Type を Box に設定した場合にのみ有効になります。このパラメーターを設定すると、カスタム吹き出し効果を実装できます。BubbleWidth または BubbleHeight を使用して字幕のサイズを変更できます。PNG、JPG、JPEG、または BMP 形式の OSS オブジェクトのみがサポートされています。例：https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-image.png。

Width

Float

No

ソース吹き出しベースマップの幅。カスタム吹き出し字幕を使用する場合は、このパラメーターが必須です。

Height

Float

No

ソース吹き出しベースマップの高さ。カスタム吹き出し字幕を使用する場合は、このパラメーターが必須です。

TextArea

String

No

バブルベースマップ内のテキストエリア。カスタムバブル字幕を使用する場合、このパラメーターは必須です。テキストエリアには、値が 0 から 1 の範囲の 4 つの浮動小数点数が含まれ、浮動小数点数はコンマ (,) で区切られます。たとえば、「0.1,0.2,0.8,0.6」と指定した場合、バブルに対するテキストボックスの左上隅の座標は 0.1 と 0.2 で、バブルに対するテキストボックスの幅と高さは 0.8 と 0.6 です。

名前

タイプ

必須

説明

Bold

ブール値

いいえ

太字

Italic

ブール値

いいえ

フォントを斜体にするかどうかを指定します。

Underline

ブール値

いいえ

下線

名前

タイプ

必須

説明

Type

String

はい

効果のタイプ。有効な値：

• Text：ビデオトラックのマテリアルにバナーテキストを追加します。

• DeWatermark：ビデオトラックのマテリアルのウォーターマークをぼかします。

• Crop：ビデオトラックのマテリアルをトリミングします。

• Pad：ビデオトラックのマテリアルにパディングを追加します。

• Scale：ビデオトラックのマテリアルのスケールを変更します。

• Transition：ビデオトラックのマテリアルにトランジション効果を追加します。

• VFX：ビデオトラックのマテリアルに視覚効果を追加します。

• Volume：オーディオトラックのマテリアルのボリュームを調整します。

• AFade：オーディオトラックのマテリアルのオーディオフェードインとフェードアウトを構成します。

• AI_ASR：オーディオまたはビデオトラックのオーディオから字幕を生成します。

SubType

String

いいえ

効果のサブタイプ。

• Type を Transition に設定した場合、このパラメーターはトランジション効果のサブタイプを指定します。詳細については、「トランジション効果のサンプル」をご参照ください

• Type を VFX に設定した場合、このパラメーターは視覚効果のサブタイプを指定します。詳細については、「視覚効果のサンプル」をご参照ください

• Type を Filter に設定した場合、このパラメーターはフィルター効果のサブタイプを指定します。詳細については、「フィルター効果のサンプル」をご参照ください