Timeline文字叠加配置示例 - 视频点播

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

参数说明

参数	说明
文字出现的坐标	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示例

全程叠加文字

全程叠加文字指从片头到片尾叠加文字，即视频全程叠加文字不需要指定TimelineIn和TimelineOut，文字在输出视频中出现的位置由X和Y设定。示例如下：

{
    "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"
                        }
                    ]
                }
            ]
        }
    ]
}

指定区域叠加文字

指定区域叠加文字指文字叠加在视频的指定时间区间，文字在输出视频中出现的位置由X和Y设定。在一个视频的第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]。

视频点播：文字叠加

相关API

参数说明

Timeline示例

全程叠加文字

指定区域叠加文字

花字样式