配置文字叠加功能的Timeline示例_智能媒体服务-阿里云帮助中心

使用说明

以下示例中的参数详情，请参见通用参数字段说明。

Timeline示例

全程叠加文字

全程叠加文字指从视频开始到结束全程叠加文字。全程叠加不需要指定TimelineIn和TimelineOut，文字在输出视频中出现的位置由横幅文字特效中的坐标X和Y设定。示例如下所示：

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

指定时间区域叠加文字

指定时间区域叠加文字指文字叠加在视频指定的时间区域。文字在输出视频中出现的位置由横幅文字特效中的坐标X和Y设定。例如，在视频的第0秒~5秒、第5秒~10秒叠加文字。示例如下所示：

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

花字样式

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

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

通用参数字段说明


参数类别	参数字段及描述
文字在视频中的坐标	X：文字左上角距离输出视频左上角的横向距离。 Y：文字左上角距离输出视频左上角的纵向距离。说明 X、Y坐标支持百分比和像素两种形式：当取值范围为(-2,2)时，表示相对输出视频宽、高的占比（X相对宽，Y相对高；如果值的小数位数大于4，小数位只保留前4位），负数表示字幕位置超出边框。当取值为≥2的整数时，表示绝对像素（如果值为浮点类型，取整）。
文字本身属性	Content：文本内容。 Font：字体，默认为宋体。更过字体详情，请参见字体列表。 FontSize：字体大小，单位为像素。 FontColor：字体颜色，使用6位十六进制RGB值表示，格式为#xxyyzz。 ColorOpacity：字体颜色的透明度，取值范围：0~1。其中，0表示完全透明，1表示完全不透明，默认值为1。 FontFace：文字样式，取值： Bold：是否加粗，默认值为false（不加粗）。 Italic：是否斜体，默认值为false（非斜体）。 Underline：是否加下划线。默认值为false（不加下划线）。 Alignment：字幕对齐方式。如果设置此参数，字幕的X、Y坐标表示margin。
文字叠加在视频中的时间区域	TimelineIn：文字相对于时间线的入点。 TimelineOut：文字相对于时间线的出点。说明如果设置的TimelineOut超过视频结束时间，则TimelineOut以实际视频结束时间为准。