文字叠加

本文为您介绍文字叠加相关参数说明和全程叠加文字、指定时间区间叠加文字、外挂字幕、花字效果配置的示例,以文字叠加场景Timeline的各种数据组织举例。

参数说明

参数

说明

文字出现的坐标

  • X:文字左上角距离输出视频左上角的横向距离。

  • Y:文字左上角距离输出视频左上角的纵向距离。

支持百分比和像素两种形式:

  • 当取值范围为0~0.9999时,表示相对输出视频宽/高的占比(X相对宽,Y相对高)。

  • 当取值为≥2的整数时,表示绝对像素。

文字本身属性

  • Content:文本内容。

  • Font:字体,该字体不填则默认为宋体。

    目前支持的字体种类有:

  • FontSize:字体大小,以像素为单位。

  • FontColor:字体颜色,形式为16进制颜色值,以#开头,如:#FFFFFF。

  • ColorOpacity:字体颜色的透明度,取值范围:0~1,1为完全不透明,0为完全透明。该字段不填则默认为1。

  • FontFace:文字的样式:

    • Bold:是否加粗。该字段不填则默认为false。

    • Italic:是否斜体。该字段不填则默认为false。

    • Underline:是否加下划线。该字段不填则默认为false。

  • Alignment:字幕对齐方式,当存在Alignment时,X/Y被当做margin

文字在输出视频叠加的时间区间

  • TimelineIn:文字相对于时间线的入点。

  • TimelineOut:文字相对于时间线的出点。

全程叠加文字示例

全程叠加指从片头到片尾叠加,即视频全程叠加文字不需要指定TimelineInTimelineOut,文字在输出视频中出现的位置由横幅文字特效(Text Effect)中的XY设定。示例如下:

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "****6f9bdb68419abfd36a7113cf****",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 31,
                            "Y": 93,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "测试文字",
                            "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": "测试文字",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 0.8123,
                            "Y": 0.7896,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "测试文字",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000"
                        },
                        {
                            "Type": "Text",
                            "X": 0.8223,
                            "Y": 0.7796,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "测试文字",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

指定时间区间叠加文字

指定时间区间叠加指文字叠加在视频的指定时间区间,文字在输出视频中出现的位置由横幅文字特效(Text Effect)中的XY设定。在一个视频的第0~5、5~10秒叠加文字,示例如下:

  • TimelineIn不设置时,默认从0开始。

  • TimelineOut不设置时,默认到视频的尾部。

  • TimelineOut超过视频尾部时,超过的时间区间自动被忽略,仍以视频轨的尾部为准。

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "****6f9bdb68419abfd36a7113cf****",
                    "Effects": [
                        {
                            "Type": "Text",
                            "X": 31,
                            "Y": 93,
                            "TimelineIn": 0,
                            "TimelineOut": 5,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "测试文字",
                            "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": "测试文字",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        },
                        {
                            "Type": "Text",
                            "X": 1124,
                            "Y": 516,
                            "TimelineIn": 5,
                            "TimelineOut": 10,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "测试文字",
                            "FontSize": 26,
                            "FontColorOpacity": 0.2,
                            "FontColor": "#000000"
                        },
                        {
                            "Type": "Text",
                            "X": 1123,
                            "Y": 515,
                            "TimelineIn": 5,
                            "TimelineOut": 10,
                            "Font": "WenQuanYi Zen Hei Mono",
                            "Content": "测试文字",
                            "FontSize": 26,
                            "FontColorOpacity": 1,
                            "FontColor": "#FFFFFF"
                        }
                    ]
                }
            ]
        }
    ]
}

外挂字幕

在字幕轨道中放置外挂字幕文件,将字幕合成到成片视频中。目前支持的外挂字幕文件格式: ass, srt。

{
    "VideoTracks":[
        {
            "VideoTrackClips":[
                {
                    "MediaId":"****756620ed48c9af022c66ee2e****"
                }
            ]
        }
    ],
    "SubtitleTracks":[
        {
            "SubtitleTrackClips":[
                {
                    "Type":"Subtitle",
                    "SubType":"srt",
                    "FileURL":"https://your-bucket.oss-cn-shanghai.aliyuncs.com/object.srt"
                }
            ]
        }
    ]
}

花字效果配置

花字是基于横幅文字特效(Text Effect)的一种特殊的文本字幕样式。

花字样式文本字幕Timeline示例

{
  "VideoTracks": [
    {
      "VideoTrackClips": [
        {
          "MediaId": "MediaId1",
          "Effects": [
            {
              "Type": "Text",
              "X": 33,
              "Y": 34,
              "Font": "WenQuanYi Zen Hei Mono",
              "Content": "带阴影带边框花字-第一段测试文字",
              "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": "第二段文字",
              "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": "第三段文字",
              "FontSize": 26,
              "FontColor": "#000000"
            }
          ]
        }
      ]
    }
  ]
}

花字参数说明

除了横幅文字支持的参数,花字还可配置以下字段:

字段名称

类型

说明

EffectColorStyle

String

花字样式类型

OutlineColour

String

描边颜色, 6位十六进制BGR值,格式为 #xxyyzz

BackColour

String

阴影颜色,6位十六进制BGR值,格式为 #xxyyzz

Shadow

Int

指定投下的阴影的深度,阴影深度的像素值,默认为0;

Outline

Int

指定描边的宽度,描边边框的像素值,默认为0;

Spacing

Int

花字/字体之间的间距,单位为像素值;

Angle

Float

角度。字幕行预先旋转过的角度,可以为浮点小数, 0-360的数值。

花字样式列表

white_grad,
red_grad,
blue_grad,
yellow_grad,
random_grad,
abstract_1,
abstract_2,
abstract_3,
aneurism,
blinds,
blue_green,
browns,
brushed_aluminium,
burning_paper,
burning_transparency,
cd,
cd_half,
caribbean_blues,
cooffee,
cold_steel,
cold_steel_2,
crown_molding,
dark_1,
deep_sea,
default_grad,
flare_glow_angular_1,
flare_glow_radial_1,
flare_glow_radial_2,
flare_glow_radial_3,
flare_glow_radial_4,
flare_radial_101,
flare_radial_102,
flare_radial_103,
flare_rays_radial_1,
flare_rays_radial_2,
flare_rays_size_1,
flare_sizefac_101,
four_bars,
full_saturation_spectrum_ccw,
full_saturation_spectrum_cw,
golden,
green,
horizon_1,
horizon_2,
incandescent,
land_1,
land_and_sea,
metallic_something,
nauseating_headache,
neon_cyan,
neon_green,
neon_yellow,
pastels,
pastel_rainbow,
purples,
radial_eyeball_blue,
radial_eyeball_brown,
radial_eyeball_grean,
radial_glow_1,
radial_rainbow_hoop,
rounded_edge,
shadows_1,
shadows_2,
shadows_3,
skyline,
skyline_polluted,
square_wood_frame,
sunrise,
three_bars_sin,
tropical_colors,
tube_red,
wood_1,
wood_2,
yellow_contrast,
yellow_orange,

花字效果

花字样式的效果参考 花字效果示例

阿里云首页 智能媒体生产 相关技术圈