点播API的媒体处理参数说明 - 视频点播

本文为您介绍点播API的媒体处理参数。

HLS标准加密配置EncryptConfig

字段名称	类型	必填项	描述
CipherText	String	是	密文密钥，用来获取明文密钥。
DecryptKeyUri	String	是	根据密文密钥获取解密密钥地址，例如：`http://example.aliyundoc.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk****`。
KeyServiceType	String	是	密钥服务类型，默认值：KMS（阿里云密钥管理服务KMS）。

EncryptConfig参数示例

{
  "CipherText":"ZjJmZGViNzUtZWY1Mi00Y2RlLTk****",
  "DecryptKeyUri":"http://example.aliyundoc.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk****",
  "KeyServiceType":"KMS"
}

转码作业参数替换配置 OverrideParams

字段名称	类型	必填项	描述
Watermarks	Watermark[]	否	水印替换必传。
SubtitleSetting	SubtitleSetting	否	字幕替换必传。说明使用到的转码模板必须先配置字幕参数，否则不做字幕参数覆盖，详细字幕配置请参见SubtitleConfig。覆盖的字幕文件地址必须是HTTP（非HTTPS）的OSS地址，不支持CDN加速域名地址，例如：`http://out-dda****.cn-shanghai.aliyuncs.com/subtitle/subtitle.ass`
PackageSubtitleSetting	PackageSubtitleSetting[]	否	多码率自适应打包中的字幕地址覆盖时，该参数必传。
TranscodeTemplateList	TranscodeTemplate[]	否	模板参数替换必传支持转码模板中 Video、Audio、Clip、Rotate、TranscodeFileRegular参数覆盖。原画模板不支持参数覆盖。参数覆盖时 TranscodeTemplateId必传。

说明

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

TranscodeTemplateList示例

        [
                {
                  "TranscodeTemplateId":"9580424e49b28c952a46544e3e8f****",
                  "Video":{
                          "Width":720,
                          "Height":480,
                          "Bitrate":"600"
                  },
                  "Audio":{
                          "Bitrate":128
                  }，
                  "Clip":{
                          "TimeSpan":{
                                "Seek":"1"
                                "Duration":"5"
                        },
                  "Rotate":"270",
                  "TranscodeFileRegular":"{MediaId}/{JobId}/{PlayDefinition}"
                  }
                }
        ]

水印参数替换配置 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

说明：CharEncode建议设置正确的编码格式，使用auto（自动检测）可能存在误检情况。

打包字幕替换参数 PackageSubtitleSetting

字段名称	类型	必填项	描述
PackageSubtitleList	PackageSubtitle[]	是	字幕替换必传。

打包字幕替换参数 PackageSubtitle

字段名称	类型	必填项	描述
SubtitlePackageTemplateId	String	是	字幕打包模板ID。
Language	String	是	语言类型，请参考RFC5646，例如：en-US。说明 Language参数仅用于检索需要替换的字幕文件，而Language本身不会被替换。
SubtitleUrl	String	是	字幕地址，仅支持HTTP的OSS地址，不支持HTTP CDN地址和HTTPS地址。说明目前仅支持一个HTTP地址。字幕文件仅支持存储在点播分配的系统Bucket中。

说明

SubtitlePackageTemplateId和Language用于检索对应需要替换的字幕地址，语言类型本身无法替换。

OverrideParams参数示例

{
  "Watermarks":[
    {
      "WatermarkId":"watermark1",
      "FileUrl":"http://****.bucket.aliyuncs.com/image/replace.png"
    },
    {
      "WatermarkId":"watermark2",
      "Content":"水印测试"
    }
  ],
  "SubtitleSetting":{
          "SubtitleList":[
                {
                "SubtitleUrl":"http://outin-****.oss-cn-shanghai.aliyuncs.com/subtitles/7b850b-724c-4011-b885-dd16c****.ass",
                "CharEncode":"UTF-8"
                },
                {
                "SubtitleUrl":"http://outin-****.oss-cn-shanghai.aliyuncs.com/subtitles/7b86db-724c-4011-b885-dd161d****.srt",
                "CharEncode":"auto"
                }
        ]
  },
  "PackageSubtitleSetting": {
    "PackageSubtitleList": [
      {
        "Language": "en-US",
        "SubtitlePackageTemplateId": "32d665807c08d25d4a5d513395****", 
        "SubtitleUrl": "http://outin-****.oss-cn-shanghai.aliyuncs.com/789679188D1F36A00AEB****.vtt" 
      },
      {
        "Language": "ja",  
        "SubtitlePackageTemplateId": "32d665807c08d25d4a5d513395ad****",
        "SubtitleUrl": "http://outin-****.oss-cn-shanghai.aliyuncs.com/F43FD90FF4B936A00AEB****.vtt"
      }
    ]
  }
}

水印配置 WatermarkConfig

如果水印类型为Image

参数名称	参数类型	必填项	描述
Dx	String	是	水平偏移，两种取值形式。像素值：[8,4096] 画面占比值：(0,1)，其中取值为0表示画面占比0%，取值为1表示画面占比100%，取值为0.5则表示画面占比50%，其他取值含义以此类推。
Dy	String	是	垂直偏移，两种取值形式。像素值：[8,4096] 画面占比值：(0,1)，其中取值为0表示画面占比0%，取值为1表示画面占比100%，取值为0.5则表示画面占比50%，其他取值含义以此类推。
Width	String	是	水印宽，两种取值形式。像素值：[8,4096] 画面占比值：(0,1)，其中取值为0表示画面占比0%，取值为1表示画面占比100%，取值为0.5则表示画面占比50%，其他取值含义以此类推。
Height	String	是	水印高，两种取值形式。像素值：[8,4096] 画面占比值：(0,1)，其中取值为0表示画面占比0%，取值为1表示画面占比100%，取值为0.5则表示画面占比50%，其他取值含义以此类推。
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暂只对图片水印生效。

字体名称 Fontname

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

视频截图

截图模板配置

SnapshotTemplateConfig

名称

类型

是否必填

描述

SnapshotType

String

是

截图类型。取值：

NormalSnapshot：普通截图。
SpriteSnapshot：雪碧图。
WebVttSnapshot：WebVtt截图。

SnapshotConfig

JSON

是

截图模板配置信息，不同的SnapshotType对应不同的模板配置内容。详细信息，请参见下文SnapshotConfig。

SnapshotConfig

说明

雪碧图是先截取普通截图，然后将普通截图拼成雪碧图，所以无论是普通截图或是雪碧截图，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	JSON	否	雪碧图配置，截图类型为雪碧图（SnapshotType取值为SpriteSnapshot）时，本参数必传。详细信息，请参见下文SpriteSnapshotConfig。
Format	String	否	输出的截图文件格式，取值：vtt （仅WebVttSnapshot类型支持该参数）。
SubOut	JSON	否	WebVttSnapshot截图方式下，控制截图的展示方式（仅WebVttSnapshot类型支持该参数）。详细信息，请参见下文SubOut。

SpriteSnapshotConfig

参数名称	类型	是否必填	描述
CellWidth	String	否	雪碧图中小图的宽，默认为普通截图的宽，单位：px。
CellHeight	String	否	雪碧图中小图的高，默认为普通截图的高，单位：px。
Padding	String	是	小图内边距大小，单位：px。
Margin	String	是	小图外边距大小，单位：px。
Color	String	是	雪碧图背景颜色，更多信息，请参见颜色设置。说明 Color暂不支持RGB值设置。
Columns	String	是	小图列数，取值范围：[1,10000]。
Lines	String	是	小图行数，取值范围：[1,10000]。
KeepCellPic	String	是	是否保留小图，取值： keep：保留。 delete：删除。

SubOut

参数名称

类型

是否必填

描述

IsSptFrag

String

是

取值：

false：截图单张分开存储。
true：截图先拼成类似雪碧图的大图统一存储。

截图模板示例

{
  "SnapshotConfig": {
    "Count": 10,
    "SpecifiedOffsetTime": 0,
    "Interval": 1
  },
  "SnapshotType": "NormalSnapshot"
}

视频动图

动图模板配置

DynamicImageTemplateConfig

参数名称	类型	是否必填	描述
Name	String	是	动图模板名称。
Video	JSON	是	动图画面参数配置。详细信息，请参见下文Video。
Container	JSON	是	动图输出格式配置。详细信息，请参见下文Container。
Clip	JSON	是	动图裁剪参数配置。详细信息，请参见下文Clip。
SetDefaultCover	String	是	截取的动图是否默认设置成视频封面。取值： true：默认设置成视频封面。 false：不设置成视频封面。

Video

说明

若Width（宽）和Height（高）都不设置，则输出的动图的尺寸和原片保持一致。
若仅设置Width（宽），则输出的动图的Height（高）会按照原片等比例进行缩放。
若仅设置Height（高），则输出的动图的Width（宽）会按照原片等比例进行缩放。

参数名称	类型	是否必填	描述
Width	String	否	输出动图的宽，取值范围：[128,4096]。
Height	String	否	输出动图的高，取值范围：[128,4096]。
Fps	String	是	帧率，取值范围：(0,60]。

Container

参数名称

类型

是否必填

描述

Format

String

是

动图输出格式。取值：

webp
gif

Clip

参数名称	类型	是否必填	描述
TimeSpan	JSON	是	动图截取时间线配置。详细信息，请参见下文TimeSpan。

TimeSpan

说明

如需按持续时长的方式截取动图，则需同时传入Seek和Duration参数；如需按去首尾的方式截取动图，则需同时传入Seek和End参数。
如果同时传入了Seek、Duration和End参数，将按照Seek和End参数来生效。

参数名称	类型	是否必填	描述
Seek	String	是	视频动图截取的开始时间点。格式一：sssss[.SSS]，取值范围：[0.000，86399.999]。示例：0 格式二：hh:mm:ss[.SSS]，取值范围：[00:00:00.000,23:59:59.999]。示例：00:00:05.003
Duration	String	否	视频裁剪的持续时长。格式一：sssss[.SSS]，取值范围：[0.000，86399.999]。示例：15 格式二：hh:mm:ss[.SSS]，取值范围：[00:00:00.000,23:59:59.999]。示例：00:00:10.003
End	String	否	视频裁剪需要丢弃的尾部时长。传入此参数时，传入的Duration参数失效。格式一：sssss[.SSS]，取值范围：[0.000，86399.999]。示例：12000.55 格式二：hh:mm:ss[.SSS]，取值范围：[00:00:00.000,23:59:59.999]。示例：00:00:15.003

动图模板示例

{
  "Video": {
    "Fps": 5,
    "Width": 1024
  },
  "Clip": {
    "TimeSpan": {
      "Seek": 0,
      "Duration": 15
    }
  },
  "Container": {
    "Format": "gif"
  },
  "SetDefaultCover": "false"
}