本文介绍参数详情。

Input详情

说明 本参数为提交转码作业相关参数。
参数类型是否必选描述
BucketString是输入文件所在OSS Bucket。

需在控制台中资源控制频道里的Bucket授权页面授予此Bucket读权限给媒体处理服务，遵守OSS Bucket定义，更多信息请参见术语表。

LocationString是输入OSS Bucket所在数据中心（OSS Location）。

遵守OSS Location定义，更多信息请参见术语表。

ObjectString是输入文件 （OSS Object）。

URL遵循RFC 2396（UTF-8编码，并进行URLEncode，更多信息，请参见URL Encoding说明），遵守OSS Object定义，更多信息请参见术语表。

RefererString否用户自行在OSS控制台设置的OSS防盗链参数，如需在单任务转码时设置referer，Input中的Referer必填。

Output详情

说明 本参数及下文部分扩展参数为提交转码作业相关参数。
参数类型是否必选描述
OutputObjectString是输出的文件名（OSS Object）。
  • 遵循RFC 2396（UTF-8编码，并进行URLEncode，更多信息，请参见URL Encoding说明。）
  • 占位符替换示例：转码输入文件若为a/b/c.flv，若OutputObject设置为%7BObjectPrefix%7D%7BFileName%7Dtest.mp4，那么转码输出文件名：a/b/ctest.mp4
  • 输出文件名支持占位符替换规则。
    • 工作流支持的占位符：代表输入文件前缀的{ObjectPrefix}、代表输入文件名的{FileName}、代表输入文件扩展名的{ExtName}、代表转码输出文件Md5值的{DestMd5}、代表转码输出文件平均码率的{DestAvgBitrate}，以及代表媒体工作流执行实例ID的{RunId}，代表工作流所处理媒体ID的{MediaId}的动态替换。
    • 非工作流支持的占位符：{ObjectPrefix}、{FileName}、{ExtName}、{DestMd5}、{DestAvgBitrate}。
  • 关于文件扩展名规则：
    • 工作流：根据转码模板容器格式自动在OutputObject后边添加扩展名。
    • 非工作流：不会自动添加扩展名，但如果容器类型为m3u8，则媒体处理服务会给Playlist自动添加扩展名.m3u8 ，分片文件名会在Playlist后自动加一个从00001开始的5位。
  • 序列号为后缀并以 - 号相连，文件扩展名为.ts。
  • 例如：Playlist文件名为filename.m3u8，则输出第一个ts分片文件为filename-00001.ts。
TemplateIdString是转码模板ID。

支持自定义转码模板与系统预置模板。

ContainerString否如设置则覆盖指定转码模板中的对应参数，更多信息请参见下文Container详情 。
VideoString否如设置则覆盖指定转码模板中的对应参数，更多信息请参见下文 Video详情。
AudioString否如设置则覆盖指定转码模板中的对应参数，更多信息请参见下文Audio详情。
AudioStreamMapString否音频流序号。
  • 格式：0:a:{序号}，示例：0:a:0。
  • 序号的含义是音频流列表的下标，序号从0开始。
  • 若不设置，选择默认的音频流。
MuxConfigString否如设置则覆盖指定转码模板中的对应参数，更多信息请参见下文MuxConfig详情。
TransConfigString否转码流程配置。如设置则覆盖指定转码模板中的对应参数，更多信息请参见下文TransConfig详情。
ClipString否JSON对象，剪辑片段，更多信息请参见下文Clip详情。

示例：{"TimeSpan":{"Seek":"123.45","Duration":"3.45"}}。

WaterMarksWaterMark[]否JSON数组，水印列表，更多信息请参见下文转码水印参数详情。
  • 水印数组大小上限为4，即同一路输出最多支持4个水印。
  • 示例：[{"InputFile":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"},"WaterMarkTemplateId":"88c6ca184c0e47098a5b665e2a126797"}]。
MergeListString否拼接设置。最多支持4个MergeURL，更多信息请参见下文MergeList拼接参数详情。
  • 单个拼接片段示例：[{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4"}]
  • 2个拼接片段示例：[{"MergeURL":"http://exampleBucket****m.oss-cn-hangzhou.aliyuncs.com/tail_comm_01.mp4","Start":"1","Duration":"20"},{"MergeURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm_02.mp4","Start":"5.4","Duration":"10.2"}]
MergeConfigUrlString否MergeList与MergeConfigUrl两个参数只支持二选一。
  • MergeConfigUrl指定的配置文件允许50个拼接片段上限。
  • MergeConfigUrl是拼接配置文件URL地址。
  • 示例：http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/mergeConfigfile
  • 只支持存放在OSS上的配置文件，且需要保证有授权给MPS可访问权限，文件内部内容请参见MergeList拼接参数详情。
  • mergeConfigfile文件内部内容示例：{"MergeList":[{"MergeURL":"http://jexampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail_comm.mp4"}]}。
M3U8NonStandardSupportString否M3U8非标准支持，JSON对象，更多信息请参见M3U8非标准参数支持详情。示例：{"TS":{"Md5Support":true,"SizeSupport":true}}。
EncryptionString否数据加密，只支持M3U8格式的输出。
  • 示例：{"Type":"hls-aes-128","Key":"ZW5jcnlwdGlvbmtleTEyMw","KeyType":"Base64","KeyUri":"aHR0cDovL2FsaXl1bi5jb20vZG9jdW1lbnQvaGxzMTI4LmtleQ=="}。
  • 更多信息请参见Encryption参数详情。
SubtitleConfigString否JSON对象，字幕配置。
  • 更多信息请参见SubtitleConfig详情。
  • 示例：{"ExtSubtitleList":[{"Input":{"Bucket":"example-bucket-****","Location":"oss-cn-hangzhou","Object":"example.srt"},"CharEnc":"UTF-8"}]}。
OpeningListString否开板列表。JSON列表。
  • 更多信息请参见Opening详情。
  • 示例：[{"OpenUrl":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/opening.flv","Start":"1","Width":"1920","Height":"1080"}]。
TailSlateListString否尾板列表，JSON列表
  • 参见TailSlate详情。
  • 示例：[{"TailUrl":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv","Start":"1","BlendDuration":"2","Width":"1920","Height":"1080","IsMergeAudio":false,"BgColor":"White"}]。
DeWatermarkString否模糊处理，JSON对象。更多信息请参见模糊处理详情。
AmixString否混音。场景如加背景音乐；同一视频，两音轨合并等。更多信息，请参见Amix混音详情。

配合AudioStreamMap参数以选择输入视频的音轨做混音。

JSON列表，示例：{"AmixURL":"[{"AmixURL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/tail.flv","Start":"1","Duration":"2"}]"}]。
UserDataString否用户自定义数据，最大长度1024个字节。
PriorityString否任务在其对应管道内的转码优先级。
  • 范围：[1，10]。
  • 最高优先级：10。
  • 默认值：6。
RotateString否视频旋转角度。

范围：[0，360)，顺时针。

Container详情

参数类型是否必选描述
FormatString否容器格式。
  • 默认值：MP4。
  • 视频转码支持FLV、MP4、HLS（M3U8+TS）、MPEG-DASH（MPD+fMP4）。
  • 音频转码支持AAC、MP3、MP4、OGG、FLAC、M4A。
  • 图片支持GIF、WEBP。
  • 容器格式为GIF时，Video Codec设置只能设置为GIF。
  • 容器格式为WEBP时，Video Codec设置只能设置为WEBP。
  • 容器格式为FLV时，Video Codec不能设置为H.265。

Video详情

参数类型是否必选含义描述
CodecString否编解码格式支持H.264、H.265、GIF、WEBP。

默认值：H.264

ProfileString否编码级别支持baseline、main、high。

默认值：high。

  • baseline：适合移动设备。
  • main：适合标准分辨率设备。
  • high：适合高分辨率设备。

最佳实践：如果您有多个清晰度，建议最低清晰度配成baseline，以保证最低端设备可播放。其他清晰度配置为main或high。

说明 目前仅H.264支持此参数。
BitrateString否视频输出文件的码率
  • 值范围：[10，50000]。
  • 单位：Kbps。
CrfString否码率-质量控制因子
  • 值范围：[0，51]。
  • 默认值：编码格式为H264，默认值为23。编码格式为H265，默认值为26。
说明 如果设置了Crf，则Bitrate的设置失效。
WidthString否宽
  • 默认值：视频原始宽度。
  • 值范围：[128，4096]。
  • 单位：px。
HeightString否高
  • 默认值：视频原始高度。
  • 值范围：[128，4096]。
  • 单位：px。
FpsString否帧率
  • 默认值：取输入文件帧率。
  • 当输入文件帧率超过60时取60。
  • 值范围：(0,60]。
  • 单位：fps。
GopString否关键帧间最大时间间隔或者最大帧数最大时间间隔时，必传单位s。
  • 默认值：10s
  • 最大帧数时，无单位
  • 值范围：[1,100000]
PresetString否视频算法器预置支持veryfast、fast、medium、slow、slower。 默认值：medium。
说明 目前仅H.264支持此参数。
ScanModeString否扫描模式支持interlaced、progressive。
BufsizeString否缓冲区大小
  • 值范围：[1000，128000]
  • 默认值：6000
  • 单位：Kb
MaxrateString否视频码率峰值值范围[10，50000]，单位Kbps。
PixFmtString否视频颜色格式范围：yuv420p，yuvj420p等标准颜色格式。

默认值：yuv420p或原始颜色格式。

RemoveString否是否删除视频流
  • true表示删除
  • false表示保留
  • 默认值：false
CropString否视频画面裁切支持2种方式。
  • 自动检测黑边并裁切，设置为“border”
  • 自定义裁切，参数格式：width:height:left:top。

    示例：1280:800:0:140

PadString否视频贴黑边参数格式：width:height:left:top。

示例：1280:800:0:140

LongShortModeString否是否开启横竖屏自适应（即：长短边模式）
  • 转码输出的宽对应输入片源的长边（竖屏为片源的高）
  • 高对应输入视频的短边（竖屏为片源的宽）
  • true表示开启
  • false表示关闭

默认值：false

以下表格显示视频转码编解码格式与容器格式的组合支持情况：
说明 HLS对音视频编码格式有要求。在使用转码业务时，如果视频选择H264编码格式，音频必须选择AAC编码格式，否则会导致转码成功但输出的文件无法播放。
ContainerAudio CodecsVideo Codecs
flvAAC、MP3H.264
mp4AAC、MP3H.264、H.265
tsAAC、MP3H.264、H.265
m3u8AAC、MP3H.264、H.265
gif不支持GIF
以下表格显示视频编解码格式与视频流配置参数的组合支持情况：
Video/CodecH.264H.265GIF
ProfileYNN
BitrateYYN
CrfYYN
WidthYYY
HeightYYY
FpsYYY
GopYYN
PresetYNN
ScanModeYYY
BufsizeYYN
MaxrateYYN
PixFmtYYbgr8

Audio详情

参数类型是否必选描述
CodecString否音频编解码格式，AAC、MP3、VORBIS、FLAC。

默认值：AAC

ProfileString否音频编码预置。

当Codec为 AAC时，范围aac_low、aac_he、aac_he_v2、aac_ld、aac_eld。

SamplerateString否采样率。
  • 默认值：44100
  • 支持22050、32000、44100、48000、96000，
  • 单位：Hz
说明
  • 若视频容器格式为flv，音频编解码格式选择为mp3时，采样率不支持32000、48000、96000；
  • 音频编解码格式为mp3时，采样率不支持96000。
BitrateString否输出文件的音频码率。
  • 值范围：[8，1000]
  • 单位：Kbps
  • 默认值：128
ChannelsString否声道数。 默认值：2。
说明
  • 当Codec设置为MP3时，声道数支持1、2。
  • 当Codec设置为AAC时，声道数支持1、2、4、5、6、8。
RemoveString否是否删除音频流。
  • true表示删除。
  • false表示保留。
  • 默认值：false。
VolumeString否音量控制，详细信息请参见下文Volume音量控制详情。
以下表格显示音频转码编解码格式与容器格式的组合支持情况：
ContainerAudio Codecs
mp3MP3
mp4AAC
oggVORBIS、FLAC
flacFLAC

Volume音量控制详情

参数类型是否必选描述
MethodString否音量调整方式。

可选值为auto, dynamic, linear。

IntegratedLoudnessTargetString否目标音量，数字。
  • 取值范围：[-70, -5]
  • 需指定Method为dynamic。
  • 默认值：-6。
TruePeakString否最大峰值，数字。
  • 取值范围：[-9, 0]。
  • 需指定Method为dynameic。
  • 默认值：-1。
LoudnessRangeTargetString否音量范围，数字。
  • 取值范围：[1, 20]。
  • 需指定Method为dynamic。
  • 默认值：8。

MuxConfig详情

参数类型是否必选描述
SegmentString否JSON对象，切片配置字段。
  • 更多信息请参见Segment详情。
  • 示例：{"Duration":"34"}。

Segment详情

参数类型是否必选描述
DurationString否分片时长。
  • 整数值
  • 单位：秒
  • 范围：[1，60]

默认值：10秒

ForceSegTimeString否指定分片时间列表，逗号分隔，最多可指定10个分片时间点。
  • 小数型，支持3位小数
  • 单位：秒
  • 示例：23、55、60 代表在23，55，60秒处分片

TransConfig详情

参数类型是否必选描述
TransModeString否转码模式。
  • 默认值：onepass。
  • 可选范围onepass、twopass、CBR。
AdjDarMethodString否分辨率改写方式。
  • 默认值：none。
  • 可选范围rescale、crop、pad、none。
IsCheckResoString否是否检查分辨率。如果输出分辨率大于输入分辨率（判断条件是宽或高），则输出分辨率等于输入分辨率。
  • true表示检查。
  • false表示不检查。
  • 默认值：false。
IsCheckResoFailString否是否检查分辨率。如果输出分辨率大于输入分辨率（判断条件是宽或高），则返回转码失败。
  • true表示检查。
  • false表示不检查。
  • 默认值：false。
IsCheckVideoBitrateString否是否检查视频码率。如果视频输出码率大于视频输入码率，则视频输出码率等于视频输入码率。
  • true表示检查。
  • false表示不检查。
  • 默认值：false。
IsCheckAudioBitrateString否是否检查音频码率。当输出音频码率大于媒体源音频码率时，则视为输出音频码率等于媒体源音频码率，即设置的音频码率参数不会生效。此值优先级小于IsCheckAudioBitrateFail。
  • true表示检查。
  • false表示不检查。
  • 默认值：
    • 参数为空，并且codec和输入源不一样：false。
    • 参数为空，并且codec和输入源一样：true。
IsCheckAudioBitrateFailString否是否检查音频码率。此值优先级大于IsCheckAudioBitrate。
  • true表示不进行转码。
  • false表示不检查。
  • 默认值：false。
IsCheckVideoBitrateFailString否是否检查视频码率。此值优先级大于IsCheckVideoBitrate。
  • true表示不进行转码。
  • false表示不检查。
  • 默认值：false。
AdjDarMethod参数位置说明：

Clip详情

参数类型是否必选描述
TimeSpanString否剪辑时间区间。

更多信息请参见下文TimeSpan详情。

ConfigToClipFirstPartBoolean否是否对第一个剪辑片段进行剪辑。
  • false：拼接完后剪辑，默认值。
  • true：先剪辑第一个片段后拼接。

TimeSpan详情

参数类型是否必选描述
SeekString否开始时间点。
  • 格式：hh:mm:ss[.SSS]
  • 取值范围 ：[00:00:00.000,23:59:59.999]

或者：

  • 格式：sssss[.SSS]
  • 取值范围［0.000，86399.999]

示例：01:59:59.999或者32000.23

DurationString否持续时长。
  • 格式：hh:mm:ss[.SSS]
  • 取值范围 ：[00:00:00.000,23:59:59.999]

或者

  • 格式：sssss[.SSS]
  • 取值范围［0.000，86399.999]

示例：01:00:59.999或者32000.23

EndString否截尾时长，表示切掉尾部的若干时长。

设置此值时，参数Duration失效。

  • 格式：hh:mm:ss[.SSS]
  • 取值范围：[00:00:00.000，23:59:59.999]

或者

  • 格式：sssss[.SSS]
  • 取值范围［0.000，86399.999］

示例：01:00:59.999或者32000.23

转码水印参数详情

参数类型是否必选描述
WaterMarkTemplateIdString否水印模板ID。
若不设置，则使用水印模板的默认配置：
  • 水印位置TopRight。
  • 偏移量Dx、Dy取0。
  • 水印宽为输出分辨率宽的0.12倍。
  • 水印高为相对水印宽的等比缩放。
InputFileString是水印输入文件。目前支持png图片、mov文件作为输入。
WidthString否若设置，则此值覆盖水印模板对应水印图片宽，值有两种形式：
  • 整数型代表水印图片宽的像素值。
    • 范围：[8，4096]
    • 单位：px
  • 小数型代表相对输出视频分辨率宽的比率。
    • 范围：(0,1)
    • 支持4位小数，如0.9999，超出部分系统自动丢弃
HeightString否若设置，则此值覆盖水印模板对应水印图片高，值有两种形式：
  • 整数型代表水印图片高的像素值。
    • 范围：[8，4096]
    • 单位：px
  • 小数型代表相对输出视频分辨率高的比率。
    • 范围：(0，1)
    • 支持4位小数，如0.9999，超出部分系统自动丢弃
DxString否若设置，则此值覆盖水印模板对应参数，水印图片相对输出视频的水平偏移量。

默认值：0

值有两种形式：
  • 整数型代表偏移像素。
    • 范围：[8，4096]
    • 单位：px
  • 小数型代表水平偏移量与输出分辨率宽的比率。
    • 范围：(0，1)
    • 支持4位小数，如0.9999，超出部分系统自动丢弃
DyString否若设置，则此值覆盖水印模板对应参数，水印图片相对输出视频的垂直偏移量。

默认值：0

值有两种形式：
  • 整数型代表偏移像素。
    • 范围：[8，4096]
    • 单位：px
  • 小数型代表垂直偏移量与输出分辨率高的比率。
    • 范围：(0，1)
    • 支持4位小数，如0.9999，超出部分系统自动丢弃
ReferPosString否若设置，则此值覆盖水印模板对应参数，水印的位置。

值范围：TopRight、TopLeft、BottomRight、BottomLeft。

TypeString否若设置，则此值覆盖水印模板对应参数。水印类型，Image、Text。默认值：Image。
  • Image：图片水印，
  • Text：文字水印，
说明 若填写Text，则必须填写TextWaterMark字段。
TimelineString否若设置，则此值覆盖水印模板对应参数，动态水印。更多信息请参见Timeline参数详情。
TextWaterMarkString否JSON对象，文字水印配置，若类型为文字水印，则此配置项不能为空。

水印模板配置详情

参数类型是否必选描述
WidthString否输出视频上水印图片宽。

值有两种形式：

  • 整数型代表水印图片宽的像素值。
    • 范围：[8,4096]
    • 单位：px
  • 小数型代表相对输出视频分辨率宽的比率。
    • 范围：(0，1)
    • 支持4位小数，如0.9999，超出部分系统自动丢弃
HeightString否输出视频上水印图片高，值有两种形式：
  • 整数型代表水印图片高的像素值。范围：[8,4096]，单位：px。
  • 小数型代表相对输出视频分辨率高的比率。
    • 范围：(0，1)
    • 支持4位小数，如0.9999，超出部分系统自动丢弃
DxString否水印图片相对输出视频的水平偏移量。

默认值：0

值有两种形式：
  • 整数型代表偏移像素。
    • 范围：[8，4096]
    • 单位：px
  • 小数型代表水平偏移量与输出分辨率宽的比率。
    • 范围：(0，1)
    • 支持4位小数，如0.9999，超出部分系统自动丢弃
DyString否水印图片相对输出视频的垂直偏移量。

默认值：0

值有两种形式：
  • 整数型代表偏移像素。
    • 范围[8，4096]
    • 单位：px
  • 小数型代表垂直偏移量与输出分辨率高的比率。
    • 范围：(0，1)
    • 支持4位小数，如0.9999，超出部分系统自动丢弃
ReferPosString否水印的位置。
  • 可取值：TopRight（右上）、TopLeft（左上）、BottomRight（右下）、BottomLeft（左下）
  • 默认值：TopRight
TypeString否水印类型，Image、Text。
  • 默认值：Image
  • 模板暂只支持Image类型
TimelineString否动态水印。更多信息请参见Timeline参数详情。

水印宽、高参数设置说明：

  • 宽、高都不设置时，水印宽取输出视频分辨率宽的0.12倍，水印高按水印原图宽高比例等比缩放。
  • 宽或高设置一边，另一边不设置时，则另一边按水印原图宽高比等比缩放。
  • 宽、高两边都设时，按实际设置值设置水印图片。
水印位置坐标说明：

Timeline参数详情

参数类型是否必选描述
StartString否水印开始出现时间。
  • 单位：秒
  • 取值范围：数字
  • 默认值：0
DurationString否水印持续时间。
  • 取值范围：[数字，ToEND]
  • 默认值：ToEND

文字水印参数详情

参数类型是否必选描述
ContentString是文字水印内容，内容需做Base64编码。

示例：若想添加文字水印“测试文字水印”，那么Content的值为：5rWL6K+V5paH5a2X5rC05Y2w。

FontNameString否默认：SimSun。 更多信息请参见支持的字体。
FontSizeInt否字体大小。
  • 默认值：16
  • 范围：(4, 120)
FontColorString否字体颜色。 取值参见FontColor。
FontAlphaInt否字体透明度。
  • 范围：(0, 1]
  • 默认：1.0
TopInt否文本上边距。
  • 默认：0
  • 范围：[0,4096]
LeftInt否文本左边距。
  • 默认：0
  • 范围：[0,4096]
BorderWidthInt否描边宽度。
  • 默认：0
  • 范围：(0,4096]
BorderColorString否描边颜色。

MergeList拼接参数详情

参数类型是否必选描述
MergeURLString是拼接片段地址。
  • 示例：http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example-object.flv
  • Object需要遵循RFC 2396（UTF-8编码，并进行URLEncode，更多信息，请参见URL Encoding说明）。
StartString否起始时间点。
  • 格式：hh:mm:ss[.SSS]或者sssss[.SSS]，
  • 示例：01:59:59.999或者32000.23
DurationString否持续时间。
  • 格式：hh:mm:ss[.SSS]或者sssss[.SSS]
  • 示例：01:59:59.999或者32000.23

M3U8非标准参数支持详情

参数类型是否必选描述
TSString否JSON对象，TS文件相关非标准支持。更多信息请参见TS参数支持详情。

TS参数支持详情

参数类型是否必选描述
Md5SupportBoolean否是否支持在M3U8文件中输出ts的md5值。
SizeSupportBoolean否是否支持在M3U8文件中输出ts文件的大小。

Encryption参数详情

参数类型是否必选描述
TypeString是取值：hls-aes-128。
KeyString是加密视频的密钥。
  • 需加密，方式见KeyType。
  • 如密钥为”encryptionkey128”, 则Base64(“encryptionkey128”)， 或 KMS(Base64(“encryptionkey128”)。
KeyUriString是密钥的访问URL，使用BASE64进行编码。
KeyTypeString是密钥Key不能明文传输给MPS，需要加密。加密方式为Base64或KMS。
说明 我们提供主密钥，请您联系我们。Base64为基础加密方式，KMS方式是在基础方式上，又使用KMS进行加密。

SubtitleConfig详情

参数类型是否必选描述
ExtSubtitleListExtSubtitle[]否JSON数组，最多4个，外部字幕列表。
  • 更多信息请参见ExtSubtitle详情。
  • 示例：[{"Input":{"Bucket":”example-bucket","Location":"oss-cn-hangzhou","Object":"example.srt"},"CharEnc":"UTF-8"}]。

ExtSubtitle详情

参数类型是否必选描述
InputString是JSON对象，外部输入字幕文件。
  • 目前支持srt、ass格式。
  • 更多信息请参见Input详情。
  • 示例：{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.srt"}。
说明
  • 目前支持{ObjectPrefix}、{FileName}、{ExtName}动态替换。
  • 示例：转码输入文件Object：a/b/c/test.flv。
  • 字幕文件用动态规则可表示为：{ObjectPrefix}{FileName}-cn.srt，遵循RFC 2396（UTF-8编码，并进行URLEncode，更多信息，请参见URL Encoding说明），Object设置为：%7bObjectPrefix%7d%7bFileName%7d-cn.srt。那么MPS会认为外挂字幕文件地址为：a/b/c/test-cn.srt。
CharEncString否外部字幕字符编码。
  • 范围：UTF-8、GBK、BIG5、auto。
  • 默认：auto。
说明 外部字幕字符编码设置为auto时，存在误检情况，建议您指定具体的字符编码。

Opening详情

参数类型是否必选描述
OpenUrlString是开板视频的OSS URL地址。
StartString否相对正片视频的开始时间。
  • 从0开始延迟多长时间后，显示开板视频。
  • 单位：秒。
  • 默认值：0。
WidthString否宽。
  • 范围：（0，4096）、-1、full。
  • -1代表片源的值。
  • full表示填满画面。
  • 默认为：-1。
HeightString否高。
  • 范围：（0，4096）、-1、full。
  • -1代表片源的值。
  • full表示填满画面。
  • 默认为：-1。

TailSlate详情

参数类型是否必选描述
TailUrlString是尾板视频的OSS URL地址。
BlendDurationString否正片视频和尾板视频过渡的时长。过渡的效果是淡入淡出：正片显示最后一帧，同时播放尾板视频，正片最后一帧逐步变暗，尾板视频逐步变亮。单位秒，默认0。
WidthString否宽。
  • 范围：（0，4096）、-1、full。
  • -1代表片源的值。
  • full表示填满画面。
  • 默认为：-1。
HeightString否高。
  • 范围：（0，4096）、-1、full。
  • -1代表片源的值。
  • full表示填满画面。
  • 默认为：-1。
IsMergeAudioBoolean否是否要拼接尾板视频的音频内容，默认为true。
BgColorString否如果尾板视频的宽、高小于正片时，设置空白处填充的背景色。默认为White，取值见bgcolor。

模糊处理详情

JSON对象： 
{
        "0": [
            {
                "l": 10,
                "t": 10,
                "w": 10,
                "h": 10
            },
            {
                "l": 100,
                "t": 0.1,
                "w": 10,
                "h": 10
            }
        ],
        "128000": [],
        "250000": [
            {
                "l": 0.2,
                "t": 0.1,
                "w": 0.01,
                "h": 0.05
            }
        ]
    }
pts：字符，指对象帧的时间戳。单位：毫秒（ms）。
  • L：数字，指模糊处理区域的左边距。
  • T：数字，指模糊处理区域的上边距。
  • W：数字，指模糊处理区域的宽度。
  • H：数字，指模糊处理区域的高度。

当T、L、W、H的值大于 1 时，表示绝对像素值。否则，表示相对片源分辨率的比例值。无论是比例值还是绝对值，都会在最终处理时进行截整处理。

以上demo中，三个pts（0，128000，250000）对应的描述信息为：
  • 0ms开始，对距离视频画面左上角10×10像素处，大小为10×10像素的Logo，以及距离左边距100像素，上边距0.1×（src_height）的位置10×10的Logo进行模糊处理。
  • 128000ms处，表示停止对Logo进行模糊处理，即，[0~128000]为对Logo进行模糊处理的时间段。
  • 250000ms开始，在左边距0.2×（src_width）、上边距0.1×（src_height）处，对大小为宽0.01×（src_width），高0.05×（src_height）的Logo进行模糊处理。

Amix混音详情

参数类型是否必选描述
AmixURLString是需要被混音的背景音轨媒体。

取值为：OSS地址或字符串"input"。

input场景：同一视频两路音轨合并。

MapString否在AmixURL中选取目标音轨，取值为：0:a:{audio_index}, 如0:a:0。
MixDurModeString否取值：first、longest。
  • first：意为输出媒体的时长以输入媒体的时长为准。
  • longest：意为输出媒体的时长以两个媒体中时长最长的为准。
  • 默认为：longest。
StartString否起始时间点，数字或时间格式。示例："1:25:36.240", "32000.23"。
DurationString否持续时长，数字或时间格式。

SnapshotConfig参数详情

说明 本参数及下文部分扩展参数为提交截图作业相关参数。
参数类型是否必选描述
FormatString否截图数据类型。
  • 默认值：空
  • 可指定vtt表示输出webvtt
BlackLevelString否多帧截图针对首帧过滤黑屏图片判定阈值。
  • 默认值：空
  • 取值范围：[30,100]

值越小，图片黑色像素的占比越小。

  • Time>0 ，参数设置无效，放弃过滤黑屏功能
  • Time =0 ，Num>1，参数有效，且只作用于第一张图，只检测开始5秒数据，如果没有非黑屏图片，依旧返回第一帧黑屏图片
  • Time =0 ，Num=1，强制过滤黑屏，参数无效

如果需要首帧图片过滤纯黑屏，建议参数值设置成100。

使用示例：Time=0&Num=10 需要对首图做纯黑屏过滤，则设置BlackLevel= 100。

PixelBlackThresholdString否判断像素点是否为黑色点的阈值。
  • 取值范围：[0，255]
  • 例如：PixelBlackThreshold=70，即像素点颜色值小于70的都认为是黑点

说明：

  1. 该参数可配合BlackLevel参数来调整黑屏过滤效果
  2. 设置PixelBlackThreshold参数取值来调整像素点为黑点的判定范围
例如：PixelBlackThreshold=50，能过滤黑屏效果不明显，则可以相应的调整取值为PixelBlackThreshold=100来扩大黑点判定范围。
OutputFileString是输出文件定义，JSON对象。 更多信息请参见截图OutputFile详情。
TileOutputFileString否输出文件定义，JSON对象，结构同OutputFile。
  • 截图输出文件格式为jpg，若使用异步模式序列拼图且Num不等于1，则TileOutputFile的Object必须包含{TileCount}，用于区分序列截图多张输出图片的输出地址，如序列截图输出3张图片，TileOutputFile的Object为{TileCount}.jpg，则输出图片Object依次为00001.jpg，00002.jpg，00003.jpg。
  • 此参数在拼图配置必填，TileOutputFile代表最终拼成的大图地址。
TimeString是截图时间。 单位：毫秒。
IntervalString否截图间隔时间。
  • 若指定则表示异步模式序列截图，Interval必须大于等于0。
  • 默认值：10。
  • 单位：秒。
  • 其中Interval=0表示根据视频时长平均截图。
NumString否截图数量。

若指定则表示异步模式序列截图，且必须大于0。

  • 当Time＋Interval＊Num的截取点超过视频时长时，后续截图自动失效，截图完成时返回实际截取的个数。
  • 当Num=1，忽略Interval参数，表示异步单张截图。
WidthString否截图输出图片宽度。
  • 单位：px
  • 范围：[8，4096]
HeightString否截图输出图片高度。
  • 单位：px
  • 范围：[8，4096]
FrameTypeString否截图类型。
  • 普通帧：normal
  • I帧：intra
  • 默认值：normal
TileOutString否拼图配置。JSON对象。 更多信息请参见TileOut拼图配置详情。
SubOutString否Webvtt拼图配置，JSON对象。 更多信息请参见SubOut Webvtt拼图配置详情。

截图OutputFile详情

参数类型是否必选描述
BucketString是截图输出文件所在OSS Bucket。 遵守OSS Bucket定义，更多信息请参见术语表。
LocationString是截图输出OSS Bucket所在数据中心（OSS Location）。 遵守OSS Location定义，更多信息请参见术语表。
ObjectString是截图输出文件 （OSS Object）。截图输出文件格式为jpg，输出文件名需遵循RFC 2396（UTF-8编码，并进行URLEncode，更多信息，请参见URL Encoding说明）。 占位符替换示例：截图输入文件若为a/b/c.flv，若Object设置为%7BObjectPrefix%7D%7BFileName%7D%7BCount%7D.jpg，那么批量截图输出文件名：a/b/c00001.jpg，a/b/c00002.jpg…
截图输出文件名支持占位符替换
  • 工作流支持的占位符：代表输入文件前缀的{ObjectPrefix}、代表输入文件名的{FileName}、代表输入文件扩展名的{ExtName}、代表截图时间点的{SnapshotTime}、代表批量截图第几张的{Count}、以及代表媒体工作流执行实例ID的{RunId}、代表工作流所处理媒体ID的{MediaId}的动态替换。
  • 非工作流支持的占位符：代表输入文件前缀的{ObjectPrefix}、代表输入文件名的{FileName}、代表输入文件扩展名的{ExtName}、代表截图时间点的{SnapshotTime}、代表批量截图第几张的{Count}。

批量截图说明：若使用异步模式序列截图且Num不等于1，则OutputFile的Object必须包含%7BCount%7D，用于区分序列截图多张输出图片的输出地址，如序列截图输出3张图片，OutputFile的Object为%7BCount%7D.jpg，则输出图片Object依次为00001.jpg，00002.jpg，00003.jpg。

TileOut拼图配置详情

参数类型是否必选描述
LinesString否图片拼合行数。
  • 整型
  • 取值范围：(0，10000]
  • 默认：10
ColumnsString否图片拼合列数。
  • 整型
  • 取值范围：(0，10000]
  • 默认：10
CellWidthString否单图片宽度。默认截图输出分辨率宽度。
CellHeightString否单图片高度。默认截图输出分辨率高度。
MarginString否外框宽度。
  • 默认：0
  • 单位：px
PaddingString否图片间距，默认0，单位px。
ColorString否背景颜色。
  • 取值范围：颜色关键字，random
  • 默认：black
  • 其中颜色关键字支持三种格式，比如黑色，支持Black，black，#000000
IsKeepCellPicString否是否保留单图片。
  • 取值范围：true、false
  • 默认：true

SubOut Webvtt拼图配置详情

参数类型是否必选描述
IsSptFragString否图片是否拼合输出。
  • true表示拼合输出
  • 默认：false

NotifyConfig详情

参数类型是否必选描述
QueueNameString否阿里云消息服务中创建的队列。
  • 媒体处理服务支持在管道上绑定队列，则该管道上的作业执行结束时会将执行结果发送到该队列。
  • 获取队列中的消息参见接收消息通知。
  • 管道上设置队列时，请您在消息服务中预先创建队列。
TopicString否阿里云消息服务中创建的主题。
  • 媒体处理服务支持在管道上绑定主题，则该管道上的作业执行结束时会将执行结果发送到该主题。
  • 主题会将执行结果以消息形式推送到订阅的地址上。
  • 消息管道上设置主题时，请预先在消息服务中预先创建主题。

转码作业输入详情

参数类型是否必选描述
BucketString是输入文件所在OSS Bucket。
  • 需在控制台中资源控制频道里的Bucket授权页面授予此Bucket读权限给媒体处理服务。
  • 遵守OSS Bucket定义，更多信息请参见术语表。
LocationString是输入OSS Bucket所在数据中心（OSS Location）。

遵守OSS Location定义，更多信息请参见术语表。

ObjectString是输入文件 （OSS Object）。
  • 遵循RFC 2396（UTF-8编码，并进行URLEncode，更多信息，请参见URL Encoding说明）。
  • 遵守OSS Object定义，更多信息请参见术语表。
AudioString否源媒体文件的音频配置，JSON对象。
说明 当输入文件为ADPCM、PCM格式时，此参数为必填项。
  • 更多信息请参见InputAudio详情。
  • 示例：{"Channels":"2","Samplerate":"44100"}。
ContainerString否源媒体文件容器配置，JSON对象。
说明 当输入文件为ADPCM、PCM格式时此参数为必填项。

InputContainer详情

参数类型是否必选描述
FormatString是源媒体音频格式。

取值：alaw、f32be、f32le、f64be、f64le、mulaw、 s16be, s16le, s24be、s24le、s32be、s32le、s8、u16be、u16le、 u24be、u24le、u32be、u32le、u8

InputAudio详情

参数类型是否必选描述
ChannelsString是源媒体音频声道数。 范围：[1，8]。
SamplerateString是源媒体音频采样率。
  • 范围：(0，320000]
  • 单位：Hz

AnalysisConfig详情

参数类型是否必选描述
QualityControlString否输出质量控制，JSON对象。 更多信息请参见AnalysisConfig详情。
PropertiesControlString否属性控制，JSON对象。 更多信息请参见PropertiesControl详情。

QualityControl详情

参数类型是否必选描述
RateQualityString否输出质量等级。
  • 值范围：(0，51）
  • 值为整数
  • 默认值：25
MethodStreamingString否播放方式，network或local。

默认值：network

PropertiesControl详情

参数类型是否必选描述
DeinterlaceString否强制扫描模式判定。
  • Auto：自动。
  • Force：强制做deinterlace。
  • None：强制不做。
CropString否视频裁切配置。
  • 默认：自动。
  • 如此值不是空JOSN{}，则它的属性Mode必填。
  • 更多信息请参见Crop详情。

Crop详情

参数类型是否必选描述
ModeString否如Crop不是空JOSN{}，则此值必填。取值：
  • Auto：自动
  • Force：强制
  • None：强制不做
WidthInteger否裁切后宽。
  • 范围：[8，4096]
  • 如MODE为Auto、None，此值失效
HeightInteger否裁切后高。
  • 范围：[8，4096]
  • 如MODE为Auto、None，此值失效
TopInteger否裁切上边距。
  • 范围：[8，4096]
  • 如MODE为Auto、None，此值失效
LeftInteger否裁切左边距。
  • 范围：[8，4096]
  • 如MODE为Auto、None，此值失效

TransFeatures详情

参数类型是否必选描述
MergeListString否视频拼接配置字段。
  • JSON数组，最多支持4个MergeURL。更多信息请参见MergeList拼接参数详情。
  • 示例：[{"MergeURL":"http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/k/mp4.mp4"},{"MergeURL":"http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/c/ts.ts","Start":"1:14","Duration":"29"}]。

作业输出文件详情

参数类型是否必选描述
URLString否输入文件的OSS URL。
  • 示例：http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/example.flv。
  • 若不指定URL，则Bucket、Location、Object必填。
BucketString否
  • 若不指定URL，则此值必填。
  • 否则，此值失效，输出文件所在OSS Bucket，需在控制台中资源控制频道里的Bucket授权页面授予此Bucket写权限给媒体处理服务。
  • 遵守OSS Bucket定义，更多信息请参见术语表。
LocationString否
  • 若不指定URL，则此值必填。
  • 否则，此值失效，输出OSS Bucket所在数据中心（OSS Location）。
  • 遵守OSS Location定义，更多信息请参见术语表。
ObjectString否
  • 若不指定URL，则此值必填。
  • 若此值失效，输出文件 （OSS Object）遵循RFC 2396（UTF-8编码，并进行URLEncode，更多信息，请参见URL Encoding说明）。
  • 遵守OSS Object定义，更多信息请参见术语表。

MultiBitrateVideoStream详情

参数类型是否必选描述
URIString否视频流输出名称，必须以.m3u8结尾，示例：a/b/test.m3u8，格式：^[a-z]{1}[a-z0-9./-]+$。
RefActivityNameString是关联的活动名称。
ExtXStreamInfoJson是码流属性。示例：{"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}。

ExtXMedia详情

参数类型是否必选描述
NameString是必填项，描述，对应于HLS V5协议的NAME,最多64字节，UTF-8。
LanguageString否可选项，语言类型，RFC5646，对应于HLS V5协议LANGUAGE。
URIString是必填，资源路径。

示例：a/b/c/d/audio-1.m3u8，格式：^[a-z]{1}[a-z0-9./-]+$。

MasterPlayList详情

参数类型是否必选描述
MultiBitrateVideoStreamsJsonArray是多码流数组。示例：[{"RefActivityName": "video-1","ExtXStreamInfo": {"BandWidth": “111110”,"Audio":"auds","Subtitles": "subs"}}]。

ExtXStreamInfo详情

参数类型是否必选描述
BandWidthString是带宽。总码率上限，必填项，对应于HLS V5协议的BANDWIDTH。
AudioString否音频流分组ID。可选，对应于HLS V5协议的AUDIO。
SubtitlesString否字幕流分组ID。可选，对应于HLS V5协议的SUBTITLES。

AdaptationSet详情

参数类型是否必选描述
GroupString是必填，组名，示例如下：
<AdaptationSet group="videostreams" mimeType="video/mp4" par="4096:1744"
              minBandwidth="258157" maxBandwidth="10285391" minWidth="426" maxWidth="4096"
              minHeight="180" maxHeight="1744" segmentAlignment="true"
              startWithSAP="1">
LangString否语言。音频和字幕活动时，可填。

Representation详情

参数类型是否必选描述
IdString是必填，流ID，示例如下：
<Representation id="240p250kbps" frameRate="24" bandwidth="258157"
              codecs="avc1.4d400d" width="426" height="180">
URIString是必填，资源路径。示例：a/b/c/d/video-1.mpd，格式：^[a-z]{1}[a-z0-9./-]+$。

InputConfig详情

参数类型是否必选描述
FormatString是必填，字幕文件的输入格式。支持 stl、ttml、vtt。
InputFileString是
{"Bucket":"example-bucket-****","Location":"oss-cn-hangzhou","Object":"example-logo****.png"}
              或
              {"URL":"http://exampleBucket****.oss-cn-hangzhou.aliyuncs.com/subtitle/test****.chs.vtt"}