名称 | 类型 | 描述 | 示例值 |
---|---|---|---|
object | 视频处理参数配置。 | ||
DisableVideo | boolean | 是否禁用视频流生成,取值范围如下:
| false |
Stream | array | 需要处理的源文件视频流索引号列表。空值(默认)表示处理索引号最小的视频流(第一路视频流),索引号大于 100 表示处理所有视频流。
说明
只处理索引号存在的视频流,索引号对应的视频流不存在时将忽略该索引号。
| |
integer | 需要处理的视频流索引号。 | 0 | |
TranscodeVideo | object | 视频转码参数,空值表示禁用视频处理,输出文件中将不包含视频流。 说明
不推荐通过将该参数设为空值来禁用视频处理。
| |
Codec | string | 视频编码格式。取值范围如下:
| h264 |
PixelFormat | string | 像素格式,默认与源视频一致。取值范围如下:
说明
yuva420p 仅在 API 为 CreateMediaConvert 时可用,且参数 Codec 必须为 vp9。
| yuv420p |
FrameRateOption | string | 帧率选项。取值范围如下:
默认值:
说明
该参数需要与参数 FrameRate 一同设置。
| fixed |
FrameRate | float | 视频帧率,默认与源视频一致。 | 25 |
ResolutionOption | string | 分辨率选项。取值范围如下:
默认值:
说明
该参数需要与参数 Resolution 一同设置。
| fixed |
Resolution | string | 输出视频的分辨率,格式为
说明
若源视频存在旋转信息,宽高、长短边的判断以旋转后的情况为准,即以播放分辨率为准。
| 640x480 |
AdaptiveResolutionDirection | boolean | 是否开启自适应分辨率方向。取值范围如下:
| true |
ScaleType | string | 缩放模式。取值范围如下:
说明
该参数需要与参数 Resolution 一同设置。
| crop |
Rotation | integer | 视频顺时针旋转的度数。取值范围如下:
| 90 |
BitrateOption | string | 视频码率选项。取值范围如下:
默认值:
说明
该参数需要与参数 Bitrate 一同设置。
| fixed |
Bitrate | integer | 视频流码率,单位为比特每秒(bit/s), 说明
该参数与 CRF 互斥,若该参数与参数 CRF 都为空值则按照参数 CRF 为 23 进行编码。
| 128000 |
GOPSize | integer | 关键帧间隔帧数,默认值为 150。 说明
API 为 GenerateVideoPlaylist 时不支持该参数。
| 60 |
CRF | float | 指定恒定质量模式。与参数 Bitrate 互斥,取值范围为[0,51],数值越大画质越差,建议取值范围为[18,38]。 | 18 |
BufferSize | integer | 动态码率下解码缓存大小,单位为比特每秒(bps)。 说明
该参数需要与参数 CRF 一起使用才有效。
| 4000000 |
MaxBitrate | integer | 动态码率下限定最大码率。使用该参数时,必须指定参数 BufferSize。 说明
该参数需要与参数 CRF 一起使用才有效。
| 128000 |
BFrames | integer | 连续 B 帧的数量,默认值为 3。 | 3 |
Refs | integer | 参考帧的数量,默认值为 2。 | 2 |
FilterVideo | object | 视频处理参数,参数 TranscodeVideo 为空时或TranscodeVideo.Codec为 copy 时,本参数无效。 说明
API 为 GenerateVideoPlaylist 时不支持设置此参数。
| |
Watermarks | array<object> | 视频水印列表。 | |
object | 视频水印信息。 | ||
Type | string | 水印类型。取值范围如下:
| text |
Dx | float | 取值为整数或小数时不同含义如下:
| 0 |
Dy | float | 取值为整数或小数时的不同含义如下:
| 0 |
StartTime | double | 添加水印的开始时间,单位为秒(s),默认从视频起始时间开始。 | 0 |
Duration | double | 添加水印持续的时间,单位为秒(s),默认值持续到视频结束。 | 0 |
ReferPos | string | 添加水印的基准位置。取值范围如下:
| topleft |
Content | string | 文字水印的内容,默认值为空。 注意 当参数Type取值为text时此参数生效。 | example |
FontName | string | 文字水印的字体名称。取值范围如下:
注意 当参数Type取值为text时此参数生效。 | SourceHanSans-Bold |
FontSize | integer | 文字水印的字体大小,默认值为 16。取值为整数,取值范围为(4,120)。 注意 当参数Type取值为text时此参数生效。 | 18 |
FontColor | string | 水印文字的字体颜色。格式为#RRGGBB,默认值为#000000。也支持输入“red”、"green"等值。 注意 当参数Type取值为text时此参数生效。 | red |
FontApha | float | 文字水印的字体透明度。取值范围为(0,1],默认值为 1,表示完全不透明。 注意 当参数Type取值为text时此参数生效。 | 0.8 |
BorderWidth | integer | 文字水印的描边宽度,单位为像素(px)。取值只能为整数,取值范围为[0,4096],默认值为 0。 注意 当参数Type取值为text时此参数生效。 | 2 |
BorderColor | string | 水印文字的描边颜色。格式为#RRGGBB,默认值为#000000。也支持输入“red”、"green"等值。 注意 当参数Type取值为text时此参数生效。 | red |
URI | string | 水印文件的 OSS 地址,支持的格式为 PNG 和 MOV。 OSS 地址规则为 注意 当参数Type取值为file时此参数生效。 | oss://test-bucket/watermark.jpg |
Width | float | 水印图片的宽度,默认值为原水印图片的宽度。取值为整数或小数时的不同含义如下:
| 80 |
Height | float | 水印图片的高度,默认值为原水印图片的高度。取值为整数或小数时的不同含义如下:
| 40 |
Delogos | array<object> | 对视频上某矩形部分进行模糊处理,用于去除 Logo、台标等。 | |
object | 视频模糊处理参数。 | ||
StartTime | double | 添加马赛克的开始时间,单位为秒(s)。默认为从视频起始时间开始。 | 0 |
Duration | double | 添加马赛克的持续时间,单位为秒(s),默认值持续到视频结束。 | 15 |
Dx | float | 取值为整数或小数时的不同含义如下:
| 0 |
Dy | float | 默认值为 0。取值为整数或小数时的不同含义如下:
| 0 |
Width | float | 马赛克的宽度,默认值为小数型的 1.0,即占满输出视频宽度,取值为整数或小数时的不同含义如下:
| 100 |
Height | float | 马赛克的高度,默认值为小数型的 1.0,即占满输出视频高度,取值为整数或小数时的不同含义如下:
| 40 |
ReferPos | string | 添加马赛克的基准位置。取值范围如下:
| topleft |
本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。
文档内容是否对您有帮助?