文档

文字叠加

更新时间:

本文为您介绍通过OpenAPI进行视频剪辑时文字叠加场景的Timeline常用配置示例,包括全程叠加文字、指定区域叠加文字等示例。

相关API

参数说明

参数

说明

文字出现的坐标

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

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

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

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

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

文字本身属性

  • Content:文本内容。

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

    目前支持的字体种类有:

    • SimSun:宋体。

    • WenQuanYi Zen Hei:文泉驿正黑。

    • WenQuanYi Zen Hei Mono:文泉驿等宽正黑。

    • WenQuanYi Zen Hei Sharp:文泉驿点阵正黑。

    • Yuanti SC Bold:圆体-简,粗体。

    • Yuanti SC Light:圆体-简,细体。

    • Yuanti SC Regular:圆体-简,常规体。

  • FontSize:字体大小,以像素为单位。该字段不填则默认为20。

  • FontColor:字体颜色,形式为16进制颜色值,以#开头,如:#FFFFFF。该字段不填则默认为#FFFFFF。

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

  • FontFace:文字的样式:

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

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

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

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

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

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

Timeline示例

全程叠加文字

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

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
                    "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"
                        }
                    ]
                }
            ]
        }
    ]
}

指定区域叠加文字

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

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

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

  • TimelineOut超过视频尾部(对单视频来说,即视频时长)时,超过的时间区间自动被忽略,仍以视频轨的尾部为准。

{
    "VideoTracks": [
        {
            "VideoTrackClips": [
                {
                    "MediaId": "ea9a6f9bdb68419abfd36a7113cf****",
                    "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"
                        }
                    ]
                }
            ]
        }
    ]
}

花字样式

花字是基于横幅文字特效的一种特殊的文本字幕样式。示例如下:

{
  "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位十六进制RGB值表示,格式为#xxyyzz。

BackColour

string

阴影颜色,使用6位十六进制RGB值表示,格式为#xxyyzz。

Shadow

int

花字阴影深度的像素值,默认为0。推荐缩放比为2∶25,例如,字体大小设置为25号,则阴影深度设置为2。

Outline

int

花字描边宽度的像素值,默认为0。推荐缩放比为2∶25,例如,字体大小设置为25号,则描边宽度设置为2。

Spacing

int

花字字体之间的间距,单位为像素。

Angle

float

字幕行预先旋转过的角度,取值范围:[0,360]。