テキストオーバーレイ - ApsaraVideo VOD - Alibaba Cloud ドキュメントセンター

このトピックでは、テキストオーバーレイのパラメーターについて説明します。このトピックでは、フルタイム間隔でのオーバーレイと指定された時間間隔でのオーバーレイの例も示します。次の例は、テキストオーバーレイ用にタイムラインデータを整理する方法を示しています。

概要

パラメーター

パラメーター	説明
出力ビデオにオーバーレイされたテキストの座標	X: テキストの左上隅と出力ビデオの左上隅との間の水平距離。 Y: テキストの左上隅と出力ビデオの左上隅との間の垂直距離。値をパーセンテージまたはピクセル数に設定できます。値が0〜0.9999の範囲にある場合、出力ビデオの幅または高さに対するテキストの水平または垂直の距離の割合を示します。 Xは幅の割合を示し、Yは高さの割合を示します。値が8以上の整数である場合、値はピクセルの数を示します。
テキスト属性	Content: テキストコンテンツ。フォント: テキストで使用されるフォント。デフォルト値: SimSun。有効な値：シムサン WenQuanYi Zen Hei WenQuanYi Zen Hei Mono WenQuanYi Zen HeiシャープユアンティSCボールド Yuanti SCライトユアンティSCレギュラー FontSize: フォントサイズ。単位: ピクセルデフォルト値は 20 です。 FontColor: フォントの色。16進カラー値です。値は数字記号 (#) で始まります。例: #FFFFFF。デフォルト値: #FFFFFF。 ColorOpacity: フォントの色の透明度。有効な値は 0～1 です。値1は、色が完全に不透明であることを示します。値0は、色が完全に透明であることを示します。デフォルト値は 1 です。 FontFace: フォントのスタイルで、次のパラメータが含まれています。太字: フォントが太字かどうかを指定します。デフォルト値：false Italic: フォントがイタリックかどうかを指定します。デフォルト値：false 下線: フォントに下線を付けるかどうかを指定します。デフォルト値：false
テキストが出力ビデオにオーバーレイされる時間間隔	TimelineIn: タイムラインを基準としたテキストの開始時刻。 TimelineOut: タイムラインを基準としたテキストの終了時刻。

フルタイム間隔でのオーバーレイの例

このアクションは、ビデオ全体の開始時間から終了時間まで、ビデオにテキストをオーバーレイします。 TimelineInまたはTimelineOutパラメーターを設定する必要はありません。出力ビデオ内のテキストの位置は、XとYで指定されます。例:

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 31,
                            "Y": 93,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000",
                            "FontFace": {
                                "Bold": true,
                                "Italic": false,
                                "Underline": false
                            }
                        },
                        {
                            "Type": "Text",
                            "X": 30,
                            "Y": 92,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 0.8123,
                            "Y": 0.7896,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000"
                        },
                        {
                            "Type": "Text",
                            "X": 0.8223,
                            "Y": 0.7796,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

指定した時間間隔でオーバーレイする

このアクションは、ビデオの指定された時間間隔でビデオにテキストをオーバーレイします。出力ビデオ内のテキストの位置は、XとYで指定されます。次のコードは、0秒から5秒まで、および5秒から10秒までのビデオにテキストをオーバーレイする方法の例を示しています。

デフォルトでは、TimelineInパラメーターが設定されていない場合、テキストはビデオの開始時刻からオーバーレイされます。
デフォルトでは、TimelineOutパラメーターが設定されていない場合、ビデオが終了するまでテキストはオーバーレイされたままになります。
TimelineOut値が1つのビデオの合計期間を超える場合、超過時間間隔は自動的に除外され、ビデオの終了時間までテキストがオーバーレイされたままになります。

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 31,
                            "Y": 93,
                            "TimelineIn": 0,
                            "TimelineOut": 5,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000",
                            "FontFace": {
                                "Bold": true,
                                "Italic": false,
                                "Underline": false
                            }
                        },
                        {
                            "Type": "Text",
                            "X": 30,
                            "Y": 92,
                            "TimelineIn": 0,
                            "TimelineOut": 5,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 1124,
                            "Y": 516,
                            "TimelineIn": 5,
                            "TimelineOut": 10,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000"
                        },
                        {
                            "Type": "Text",
                            "X": 1123,
                            "Y": 515,
                            "TimelineIn": 5,
                            "TimelineOut": 10,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "Test text",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

ワードアート

ワードアートは、バナーテキスト効果に基づいた特別なテキストスタイルです。例：

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "MediaId1",
          "Effects": [
            {
              "Type": "Text",
              "X": 33,
              "Y": 34,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "The first paragraph of shaded and framed test text",
              "OutlineColour": "#ee00ff",
              "BackColour": "#CE1212",
              "EffectColorStyle": "skyline",
              "Angle": 300,
              "Outline": 2,
              "Shadow": 3,
              "FontSize": 42,
              "FontColorOpacity": 1,
              "FontColor": "#000000",
              "FontFace": {
                "Bold": true,
                "Italic": false,
                "Underline": false
              }
            },
            {
              "Type": "Text",
              "X": 66,
              "Y": 256,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "The second paragraph of test text",
              "EffectColorStyle": "golden",
              "Angle": 60,
              "FontSize": 38,
              "FontColorOpacity": 0.8,
              "FontColor": "#d60e0e"
            },
            {
              "Type": "Text",
              "X": 0.7123,
              "Y": 0.7896,
              "TimelineIn": 5,
              "TimelineOut": 20,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "The third paragraph of test text",
              "FontSize": 26,
              "FontColor": "#000000"
            }
          ]
        }
      ]
    }
  ]
}

Wordアートのパラメータ

パラメーター	タイプ	説明
EffectColorStyle	String	ワードアート効果のタイプ。詳細については、「Word art effect examples」をご参照ください。
OutlineColour	String	アウトラインカラー。# xxyyzz形式で6桁の16進数のRGB値として表されます。
バックカラー	String	# xxyyzz形式で6桁の16進数のRGB値として表されるシャドウカラー。
影	int	影の深さ。単位: ピクセル。デフォルト値：0 シャドウの深さとフォントサイズの推奨比率は2:25です。たとえば、フォントサイズが25に設定されている場合、シャドウ深度は2に設定されます。
概要	int	アウトラインの幅。単位: ピクセル。デフォルト値：0 アウトライン幅とフォントサイズの推奨比率は2:25です。たとえば、フォントサイズが25に設定されている場合、アウトラインの幅は2に設定されます。
パディング	int	テキストの間隔。単位: ピクセル。
角度	float	字幕ラインが事前に回転される角度。有効な値: [0,360] 。