このトピックでは、タイムライン パラメーターを SubmitMediaProducingJob オペレーションで編集して字幕と字幕テンプレートを処理する方法について説明します。
使用方法
インテリジェントプロダクションは、ライブストリーム、VOD ファイル、Object Storage Service (OSS) の素材ファイルの編集と合成、エフェクトレンダリング、テンプレートをサポートしています。 詳細については、「インテリジェントプロダクションの概要」をご参照ください。
タイムラインパラメーター を構成し、SubmitMediaProducingJob オペレーションを呼び出すことで、1 つ以上のビデオ、オーディオファイル、画像、字幕素材からビデオを制作できます。
タイムラインは、素材を追加し、エフェクトを構成してビデオを作成するときに作成されます。 タイムラインは、トラック、素材、エフェクトで構成されます。 詳細については、「タイムラインの構成」をご参照ください。
IMS SDK を使用してオーディオファイルとビデオファイルを編集する方法の詳細については、「準備」をご参照ください。
ビデオに字幕を追加する
字幕は、別のトラック (SubtitleTracks) を作成するか、エフェクトで設定することでビデオに追加できます。
TimelineIn パラメーターと TimelineOut パラメーターを使用して、字幕の開始時刻と終了時刻を定義できます。 これら 2 つのパラメーターを指定しない場合、字幕トラックの字幕はビデオ全体の長さに合わせて生成されます。 デフォルトでは、エフェクトで追加された字幕は、エフェクトが属するビデオクリップの長さに合わせて生成されます。
\N または \n を使用して、複数行で字幕を表示できます。
エフェクト | タイムラインの例 |
|
フォントサイズ、システムフォント、カスタムフォント、ストローク、シャドウ、字幕の回転角度を構成する
FontSize は字幕のフォントサイズを示します。 エフェクトで字幕を追加する場合は、FixedFontSize を使用してフォントサイズを設定することをお勧めします。これにより、字幕がビデオサイズに合わせて変化しなくなります。
Font はシステムフォントを指定し、FontURL はカスタムフォントを格納する OSS オブジェクトへのパスを指定します。 両方のパラメーターが設定されている場合、システムは優先的に FontURL を使用して字幕をレンダリングします。
Outline、OutlineColour、Shadow、BackColour などのパラメーターを使用して、シンプルな単層ストロークとシャドウエフェクトを生成できます。 複雑な多層ストロークエフェクトを実装するには、例 3 のカスタムワードアートの構成例を参照してください。
Angle を使用して、字幕の回転角度を反時計回りに調整できます。
エフェクト | タイムラインの例 |
|
ワードアートを構成する
EffectColorStyleId フィールドを使用して、ワードアートエフェクトを簡単に構成できます。 エフェクトの詳細については、「ワードアートエフェクト」をご参照ください。
字幕の外観をカスタマイズするには、SubtitleEffects フィールドを使用して、複数層のストロークとシャドウエフェクトを構成できます。 詳細については、「SubtitleEffect」をご参照ください。
エフェクト | タイムラインの例 |
|
字幕の一部にエフェクトを構成する
上書きコードを Content フィールドに追加して、字幕の一部にエフェクトを構成できます。 上書きコードを追加する際は、以下の点に注意してください。
すべての書き込みコードは、2 つのバックスラッシュ (\\) で始める必要があります。
すべての書き込みコードは、中括弧 ({ }) で囲む必要があります。 1 組の中括弧に複数行のコードを含めることができます。
上書きコードは字幕に適用されます。 元の構成に戻すには、対応するコードを追加して上書きをキャンセルします。
次の表に、上書きコードのパラメーターを示します。
パラメーター | 説明 | Content の例 |
|
| "{\\1c&00FF7F&}緑色{\\1c} のテキスト" |
| 注: このチュートリアルでは、基本的な JavaScript の知識があることを前提としています。 | このガイドが WordPress の管理画面を使いこなすためのお役に立てれば幸いです。 |
\\b1 \\b0 | b1 は太字を示し、b0 は太字ではないことを示します。 | "{\\b1}太字{\\b0}テキスト" |
\\i1 \\i0 | i1 はイタリック体を示し、i0 はイタリック体でないことを示します。 | "{\\i1}Italicize{\\i0} text" |
\\u1 \\u0 | u1 は下線を、u0 は下線なしを示します。 | "{\\u1}下線{\\u0} テキスト" |
\\s1 \\s0 | s1 は取り消し線を表し、s0 は取り消し線なしを表します。 | "{\\s1}Strikethrough{\\s0} text" |
\\fs[フォントサイズ] | 字幕のフォントサイズです。単位:ピクセル。 | "Size {\\fs100}100{\\fs} text" |
\\fn[フォント] | 字幕のフォントです。カスタムフォントは指定できません。 | "{\\fnKaiTi}Heiti{\\fn} テキスト" |
効果 | タイムライン例 |
|
自動改行の設定
字幕が完全に表示されるようにするには、字幕がウィンドウの範囲を超えた場合に自動改行を有効にするために、AdaptMode を AutoWrap に設定できます。さらに、TextWidth を絶対ピクセル数または再生ウィンドウのパーセンテージで指定して、定義された幅範囲内で改行を制御できます。
「AdaptMode」: 「AutoWrapAtSpaces」の設定により、英語の単語の途中で改行が発生しないようにすることができます。
効果 | タイムライン例 |
|
字幕の配置を設定する
字幕の位置は、配置モードによって異なります。次の表に、配置モードとデフォルトの位置を示します。
配置
配置モード
デフォルトの位置
TopLeft
左揃え
左上隅。
TopCenter
中央揃え
上部中央。
TopRight
右揃え
右上隅。
CenterLeft
左揃え
水平方向は中央揃えですが、テキストは左揃えです。
CenterCenter
中央揃え
水平方向と垂直方向の中央揃え。
CenterRight
右揃え
水平方向は中央揃えですが、テキストは右揃えです。
BottomLeft
左揃え
左下隅。
BottomCenter
中央揃え
下部中央。
BottomRight
右揃え
右下隅。
次の表に、字幕を正確に配置できる3つの配置モード(左、中央、右)を示します。
配置
配置モード
配置基準点
Left
左揃え
字幕テキストボックスの左上頂点。
Center
中央揃え
字幕テキストボックスの上枠線の中点。
Right
右揃え
字幕テキストボックスの右上頂点。
次の図は、さまざまな配置モードのさまざまな配置基準点を示しています。

効果 | タイムラインの例 |
|
字幕効果の設定
字幕の開始効果と終了効果を表示する時間を指定し、ループ効果の速度を指定できます。
開始/終了効果とループ効果は同時に使用できません。
効果 | タイムライン例 |
|
字幕の背景を設定する
字幕効果のボックスフィールドを使用して、字幕に単色の背景を追加できます。ワードアート、折り返し、その他のスタイルも設定できます。
効果 | タイムラインの例 |
|
吹き出しテキストを設定する
BubbleStyleId を使用して、吹き出しスタイルの ID を指定できます。 吹き出しスタイルの詳細については、「吹き出しテキスト」をご参照ください。
BubbleWidth と BubbleHeight を設定して、吹き出しテキストの幅と高さを調整できます。 X と Y は、それぞれビデオの左上隅を基準とした吹き出しテキストの左上隅の座標を示します。
SubtitleEffects の Box スタイルを使用すると、画像を追加してカスタムの吹き出し効果を実現できます。 このスタイルでは、Width と Height を指定して吹き出しの元の画像の幅と高さを示し、TextArea を指定して吹き出しに対するテキストボックスの位置とサイズを定義する必要があります。 TextArea の 4 つのフィールドは、吹き出しに対する吹き出しテキストボックスの左上隅の座標、および吹き出しに対するテキストボックスの幅と高さを示します。
吹き出しテキスト機能を使用すると、テキストは吹き出し内で自動的に折り返され、拡大縮小されます。
効果 | タイムライン例 |
|
字幕のスクロールを設定する
垂直スクロール:
TimelineOutを空のままにすると、システムはスクロールサイクルに基づいて字幕の継続時間を自動的に推定します。字幕スクロールの開始 (ScrollStartY) 位置と終了 (ScrollEndY) 位置、スクロールが開始位置 (ScrollStartFreeze) と終了位置 (ScrollEndFreeze) で一時停止する時間、開始時 (ScrollStartShift) と終了時 (ScrollEndShift) のオフセット、およびスクロール速度 (ScrollSpeed) を指定できます。水平スクロール: 字幕スクロールの開始 (
ScrollStartX) 位置と終了 (ScrollEndX) 位置、スクロール速度 (ScrollSpeed)、およびスクロールをループするかどうか (ScrollLoop) を指定できます。字幕は他のメディア要素と位置合わせできます。たとえば、垂直スクロールを設定するときに、
ClipIdをScrollSubtitleに設定できます。背景画像、背景音声、またはバナーテキストをスクロール字幕に合わせるには、ReferenceClipIdをScrollSubtitleに設定します。垂直スクロールの開始時間は、ビデオトラックのオープニングの継続時間と一致する必要があります。
効果 | タイムラインの例 |
|
FECanvas を使用して、異なる解像度のビデオで字幕のフォントサイズを統一する
FontSize は、ビデオ内の字幕テキストの高さが占めるピクセル数を指定します。デフォルトでは、同じ FontSize を異なる解像度のビデオに適用すると、結果として得られる比率が一致しないことがよくあります。たとえば、FontSize 100 は 480P ビデオでは大きく見えますが、720P ビデオでは比較的小さく見えます。異なる解像度のビデオで字幕のフォントサイズを統一するには、タイムラインで FECanvas を設定します。
効果 | タイムラインの例 |
|