全部产品
云市场

文字叠加

更新时间:2018-11-02 17:36:13

概述

视频剪辑的简介、总体流程和媒体合成服务的两种使用方式已在 简介 中介绍过,媒体合成最终都是通过 媒体合成服务 发起并实现的,而Timeline是该服务重点处理的数据,也是视频剪辑中最核心的对象。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
FontColorOpacity表示字体颜色的透明度,取值[0-1],1为完全不透明,0为完全透明。该字段不填则默认为1。
FontFace表示文字的样式:
Bold: 是否加粗。该字段不填则默认为false。
Italic: 是否斜体。该字段不填则默认为false。
Underline: 是否加下划线。该字段不填则默认为false。
文字在输出视频叠加的时间区间 TimelineIn表示文字在输出视频中的入点。
TimelineOut表示文字在输出视频中的出点。

样例

本文以文字叠加场景Timeline的各种数据组织举例。

全程叠加

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

  1. {
  2. "VideoTracks": [
  3. {
  4. "VideoTrackClips": [
  5. {
  6. "MediaId": "ea9a6f9bdb68419abfd36a7113cf7a7c",
  7. "Effects": [
  8. {
  9. "Type": "Text",
  10. "X": 31,
  11. "Y": 93,
  12. "Font": "WenQuanYi Zen Hei Mono",
  13. "Content": "测试文字测试文字",
  14. "FontSize": 26,
  15. "FontColorOpacity": 0.2,
  16. "FontColor": "#000000",
  17. "FontFace": {
  18. "Bold": true,
  19. "Italic": false,
  20. "Underline": false
  21. }
  22. },
  23. {
  24. "Type": "Text",
  25. "X": 30,
  26. "Y": 92,
  27. "Font": "WenQuanYi Zen Hei Mono",
  28. "Content": "测试文字测试文字",
  29. "FontSize": 26,
  30. "FontColorOpacity": 1,
  31. "FontColor": "#FFFFFF"
  32. },
  33. {
  34. "Type": "Text",
  35. "X": 0.8123,
  36. "Y": 0.7896,
  37. "Font": "WenQuanYi Zen Hei Mono",
  38. "Content": "测试文字测试文字",
  39. "FontSize": 26,
  40. "FontColorOpacity": 0.2,
  41. "FontColor": "#000000"
  42. },
  43. {
  44. "Type": "Text",
  45. "X": 0.8223,
  46. "Y": 0.7796,
  47. "Font": "WenQuanYi Zen Hei Mono",
  48. "Content": "测试文字测试文字",
  49. "FontSize": 26,
  50. "FontColorOpacity": 1,
  51. "FontColor": "#FFFFFF"
  52. }
  53. ]
  54. }
  55. ]
  56. }
  57. ]
  58. }

指定区域叠加

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

  • 当TimelineIn不设置时,默认从0开始。
  • 当TimelineOut不设置时,默认到视频的尾部。
  • 当TimelineOut超过视频尾部(对单视频来说,即视频时长)时,超过的时间区间自动被忽略,仍以视频轨的尾部为准。
  1. {
  2. "VideoTracks": [
  3. {
  4. "VideoTrackClips": [
  5. {
  6. "MediaId": "ea9a6f9bdb68419abfd36a7113cf7a7c",
  7. "Effects": [
  8. {
  9. "Type": "Text",
  10. "X": 31,
  11. "Y": 93,
  12. "TimelineIn": 0,
  13. "TimelineOut": 5,
  14. "Font": "WenQuanYi Zen Hei Mono",
  15. "Content": "测试文字测试文字",
  16. "FontSize": 26,
  17. "FontColorOpacity": 0.2,
  18. "FontColor": "#000000",
  19. "FontFace": {
  20. "Bold": true,
  21. "Italic": false,
  22. "Underline": false
  23. }
  24. },
  25. {
  26. "Type": "Text",
  27. "X": 30,
  28. "Y": 92,
  29. "TimelineIn": 0,
  30. "TimelineOut": 5,
  31. "Font": "WenQuanYi Zen Hei Mono",
  32. "Content": "测试文字测试文字",
  33. "FontSize": 26,
  34. "FontColorOpacity": 1,
  35. "FontColor": "#FFFFFF"
  36. },
  37. {
  38. "Type": "Text",
  39. "X": 1124,
  40. "Y": 516,
  41. "TimelineIn": 5,
  42. "TimelineOut": 10,
  43. "Font": "WenQuanYi Zen Hei Mono",
  44. "Content": "测试文字测试文字",
  45. "FontSize": 26,
  46. "FontColorOpacity": 0.2,
  47. "FontColor": "#000000"
  48. },
  49. {
  50. "Type": "Text",
  51. "X": 1123,
  52. "Y": 515,
  53. "TimelineIn": 5,
  54. "TimelineOut": 10,
  55. "Font": "WenQuanYi Zen Hei Mono",
  56. "Content": "测试文字测试文字",
  57. "FontSize": 26,
  58. "FontColorOpacity": 1,
  59. "FontColor": "#FFFFFF"
  60. }
  61. ]
  62. }
  63. ]
  64. }
  65. ]
  66. }