全部产品
云市场

媒体处理参数说明

更新时间:2019-08-13 16:03:04

HLS标准加密配置EncryptConfig

字段名称 类型 必填项 描述
CipherText String 密文秘钥,用来获取明文秘钥。
DecryptKeyUri String 根据密文秘钥获取解密秘钥地址,例如:http://decrypt.demo.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt。
KeyServiceType String 密钥服务类型,默认值:KMS(阿里云密钥管理服务KMS)。

EncryptConfig参数示例

  1. {
  2. "CipherText":"ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt",
  3. "DecryptKeyUri":"http://decrypt.demo.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk3MTMt",
  4. "KeyServiceType":"KMS"
  5. }

转码作业参数替换配置 OverrideParams

字段名称 类型 必填项 描述
Watermarks Watermark[] 水印替换必传
SubtitleSetting SubtitleSetting 字幕替换必传
TranscodeTemplateList TranscodeTemplate[] 模板参数替换必传
  • 支持转码模板中 Video、Audio、Clip、Rotate、TranscodeFileRegular 参数覆盖
  • 原画模板不支持参数覆盖
  • 参数覆盖时 TranscodeTemplateId 必传

说明:水印信息暂只支持对水印的图片文件、文字的内容替换。

TranscodeTemplateList示例

  1. [
  2. {
  3. "TranscodeTemplateId":"9580424e49b28c952a46544e3e8f2268",
  4. "Video":{
  5. "Width":720,
  6. "Height":480,
  7. "Bitrate":"600"
  8. },
  9. "Audio":{
  10. "Bitrate":128
  11. },
  12. "Clip":{
  13. "TimeSpan":{
  14. "Seek":"1"
  15. "Duration":"5"
  16. },
  17. "Rotate":"270",
  18. "TranscodeFileRegular":"{MediaId}/{JobId}/{PlayDefinition}"
  19. }
  20. }
  21. ]

水印参数替换配置 Watermark

字段名称 类型 必填项 描述
WatermarkId String 转码模板关联水印ID,视频点播控制台水印管理可查。
FileUrl String 水印文件OSS地址。图片水印必传,文件OSS地址获取详细参见CreateUploadAttachedMedia
Content String 文字水印内容,文字水印必传。

注意:FileUrl必须与视频源片所在存储源站保持一致。

字幕参数替换配置 SubtitleSetting

字段名称 类型 必填项 描述
SubtitleList Subtitle 替换的字幕列表

字幕配置 Subtitle

字段名称 类型 必填项 描述
SubtitleUrl String 字幕文件的OSS地址(不支持https地址)
CharEncode String 字幕内容的编码格式,取值:
  • auto(自动检测)
  • UTF-8
  • GBK
  • BIG5 > UTF-8
  • GBK
  • BIG5

说明:CharEncode建议设置正确的编码格式,使用auto(自动检测)可能存在误检情况。

OverrideParams参数示例

  1. {
  2. "Watermarks":[
  3. {
  4. "WatermarkId":"watermark1",
  5. "FileUrl":"http://test.bucket.aliyuncs.com/image/replace.png"
  6. },
  7. {
  8. "WatermarkId":"watermark2",
  9. "Content":"水印测试"
  10. }
  11. ],
  12. "SubtitleSetting":{
  13. "SubtitleList":[
  14. {
  15. "SubtitleUrl":"http://outin-40564284ef051100163e1403e7.oss-cn-shanghai.aliyuncs.com/subtitles/7b850b-724c-4011-b885-dd16cc112.ass",
  16. "CharEncode":"UTF-8"
  17. },
  18. {
  19. "SubtitleUrl":"http://outin-40564284ef0511e0163e1403e7.oss-cn-shanghai.aliyuncs.com/subtitles/7b86db-724c-4011-b885-dd161d1cyy.srt",
  20. "CharEncode":"auto"
  21. }
  22. ]
  23. }
  24. }

水印配置 WatermarkConfig

如果水印类型为Image

参数名称 参数类型 必填项 描述
Dx String 水平偏移,两种取值形式:像素值:[8,4096];画面占比值:(0,1)
Dy String 垂直偏移,两种取值形式:像素值:[8,4096];画面占比值:(0,1)
Width String 水印宽,两种取值形式:像素值:[8,4096];画面占比值:(0,1)
Height String 水印高,两种取值形式:像素值:[8,4096];画面占比值:(0,1)
ReferPos String 水印位置:BottomRight(右下)、BottomLeft(左下)、TopRight(右上)、TopLeft(左上)
Timeline Timeline (JSON字符串)水印时间线,水印效果的开始展现及结束展现时间。

注意:Timeline只对图片水印生效。

如果水印类型为Text

参数名称 参数类型 必填项 描述
Content String 文字水印内容,例如:“文字水印”。
FontName String 字体名称
FontColor String 字体颜色
FontAlpha String 字体透明度。范围:(0, 1],默认:1.0。
BorderColor String 描边颜色
Top Integer 文本上边距,只支持整型数值。默认:0 范围:[0,4096]。
Left Integer 文本左边距,只支持整型数值。默认:0 范围:[0,4096]。
FontSize Integer 字体大小,只支持整型数值。默认值:16 范围:(4, 120)。
BorderWidth Integer 描边宽度,只支持整型数值。默认:0 范围:(0,4096]。

水印时间线 Timeline

参数名称 参数类型 必填项 描述
Start String 水印开始出现时间。单位:秒,取值范围:数字,默认值:0。
Duration String 水印持续时间。单位:秒,取值范围:[数字,ToEND],默认值:ToEND(整个视频结束)。

注意:Timeline暂只对图片水印生效。

截图模板配置 SnapshotTemplateConfig

参数名称 类型 必填项 描述
SnapshotType String NormalSnapshot(普通截图)、SpriteSnapshot(雪碧图)
SnapshotConfig SnapshotConfig JSON字符串,截图配置信息,不同的SnapshotType对应不同的配置内容。

普通截图配置SnapshotConfig

参数名称 类型 必填项 描述
FrameType String 截图的帧类型:intra(关键帧)、normal(普通帧)
Count Long 需要截取的图片数
Interval Long 截图的间隔时间,必须大于等于0,单位:秒。其中,Interval为0表示按照Count数根据视频时长平均截图。
SpecifiedOffsetTime Long 截图指定时间的起始点,单位:毫秒。
Width Integer 截图宽,取值范围:[8,4096],默认原片宽,单位:px。
Height Integer 截图高,取值范围:[8,4096],默认原片高,单位:px。
SpriteSnapshotConfig SpriteSnapshotConfig 截雪碧图必传

说明:雪碧图是先截取普通截图,然后将普通截图拼成雪碧图,所以无论是普通截图或是雪碧截图,SnapshotConfig参数都必传。

雪碧图配置SpriteSnapshotConfig

字段名称 类型 必填项 描述
CellWidth String 雪碧图中小图的宽 ,默认为普通截图的宽,单位:px。
CellHeight String 雪碧图中小图的高,默认为普通截图的高,单位:px。
Padding String 小图内边距大小,单位:px。
Margin String 小图外边距大小,单位:px。
Color String 雪碧图背景颜色,详细请参考颜色设置
Columns String 小图列数 ,取值范围:[1,10000]。
Lines String 小图行数,取值范围:[1,10000]。
KeepCellPic String 是否保留小图,取值:keep(保留),delete(删除)。

说明:Color暂不支持RGB值设置。

字体名称 Fontname

字体名称 描述
SimSun 宋体
WenQuanYi Zen Hei 文泉驿正黑
WenQuanYi Zen Hei Mono 文泉驿等宽正黑
WenQuanYi Zen Hei Sharp 文泉驿点阵正黑
Yuanti SC 圆体-简 常规体