MediaConvertVideo

码率控制缓冲区大小。用于控制码率波动。详细说明请参见视频码率控制模式。 说明 Bufsize 值越大，码率的波动越大，视频质量越高。

• 单位：Kb。
• 值范围：[1000,128000]。
• 默认值：6000。

视频质量控制值（VBR 模式可用）。 说明 Qscale 值越大，视频质量越低，压缩率越高。

• 仅 Codec 为 H.264 时生效。
• 值范围：[0,51]。

扫描模式。取值如下：

• 不设置：按输入文件的原始模式。
• auto：自动去隔行。
• progressive：顺序扫描（逐行扫描）。
• interlaced：交叉扫描（隔行扫描）。
• 默认值：空，即不设置。

最佳实践：交叉扫描虽然比顺序扫描更节省数据量，但画质不佳，所以现在主流视频制作都采用顺序扫描。

• 如果您设置了顺序扫描或交叉扫描，但与原视频模式不符，会导致转码失败。
• 建议您设置原视频模式或自动去隔行，以提高兼容性。

是否开启横竖屏自适应（又称，长短边自适应）。当 Width 或 Height 至少填写一项时生效。

• true：开启。
• false：关闭。
• 默认值：false。

最佳实践：如果您的输入视频既有横屏视频也有竖屏视频，为了避免视频拉伸变形，请开启横竖屏自适应开关，并结合分辨率参数设置等比缩放。示例请参见设置横竖屏自适应。

帧率。

• 单位：fps，帧每秒。
• 值范围：(0,60]。
• 默认值：输入文件的视频原始帧率，超过 60 时取 60。
• 常见值：24、25、30。

设置相邻两个 I 帧之间的时间或者帧数间隔。

• 关键帧间最大时间间隔：{时间}s，时间范围[1,100000]。
• 关键帧间最大帧数间隔：{帧数}，帧数范围[1,100000]。
• 默认值：10s，代表每 10s 一个关键帧。

最佳实践：流媒体播放场景下，为了提高播放器开播速度和 seek 响应时长，建议设置为[2,7]s。

是否删除视频流。

• true：删除。则本节所有 Video 相关参数失效。
• false：保留。
• 默认值：false。

输出文件的视频平均码率。使用 CBR、ABR、VBR 码控必须设置 Bitrate，且 TransMode 需正确配对设置。详细说明请参见视频码率控制模式。

• 单位：Kbps。
• 值范围：-1、[10,50000]。-1 代表使用输入视频的原始码率。

最佳实践：

• CBR 固定码率模式：需设置 TransMode 为 CBR，且 Bitrate=Maxrate=Bufsize。
• ABR 平均码率模式：需设置 TransMode 为 onepass，且指定 Bitrate。还可指定 Maxrate 和 Bufsize 控制码率波动范围。
• VBR 动态码率模式：需设置 TransMode 为 twopass，且指定 Maxrate（或 BitrateBnd）和 Bufsize 参数。

编码级别。更多信息请参见基本概念。

• 仅 Codec 为 H.264 时生效。
• 可选值：baseline、main、high。
• 默认值：high。

最佳实践：一个视频输出多清晰度时，建议最低清晰度设置 baseline，以保证最低端设备可播放。其他清晰度设置为 main 或 high。

视频画面剪裁。支持自动去黑边或自定义剪裁。

• 请在输入视频分辨率大于输出视频分辨率时使用。不要设置分辨率改写参数 AdjDarMethod。
• 自动去黑边：border。
• 自定义剪裁：参数格式为{width}:{height}:{left}:{top}。
  • width：剪裁后，输出视频的宽度。
  • height：剪裁后，输出视频的高度。
  • left：输出画面距离原画面的左边距。
  • top：输出画面距离原画面的上边距。

自定义剪裁示例：1920:800:0:140。

视频编码格式。

• 可选值：H.264、H.265、AV1、GIF、WEBP。更多格式和与 Container 的兼容要求，请参见格式支持。
• 默认值：H.264。

输出文件的视频码率峰值。详细说明请参见视频码率控制模式。

• 单位：Kbps。
• 值范围：[10,50000]。

视频贴黑边。

• 请在输入视频分辨率小于输出视频分辨率时使用。不要设置分辨率检查参数 IsCheckReso 和 IsCheckResoFail、不要设置分辨率改写参数 AdjDarMethod。
• 参数格式：{width}:{height}:{left}:{top}。
  • width：贴黑边后，输出视频的宽度。
  • height：贴黑边后，输出视频的高度。
  • left：原画面距离输出画面的左边距。
  • top：原画面距离输出画面的上边距。

示例：1920:1080:0:140。

最大帧率。

质量控制因子。使用 Crf 码控必须设置 Crf，且 TransMode 需设置为 fixCRF，详细说明请参见视频码率控制模式。 说明 Crf 值越大，视频质量越低，压缩率越高。

• 值范围：[20,51]。
• 默认值：Codec 为 H.264 时，默认值为 23；Codec 为 H.265 时，默认值为 26；Codec 为 AV1 时，默认值为 32。

最佳实践：

• 0 为无损，51 为最差。建议取值[23,29]。您可根据画面复杂度进行调节。每增加或减少 6，码率会减少一半或增加一倍，通常同等清晰度下动画片可以比实拍设置得更高。
• Crf 以质量为目标，输出视频码率不可预知，可结合 Maxrate、Bufsize 来控制码率波动范围。

高度（或短边）。当 LongShortMode 为 false 或未设置时，代表视频的高度。当 LongShortMode 为 true 时，代表视频的短边。

• 单位：px。
• 值范围：[128,4096]，必须为偶数。
• 默认值
  • 当 Width 和 Height 都未设置：使用输入视频的原始高度（或短边）。
  • 当仅设置 Width：按照输入视频的原始比例计算。

宽度（或长边）。当 LongShortMode 为 false 或未设置时，代表宽度。当 LongShortMode 为 true 时，代表视频的长边。

• 单位：px。
• 值范围：[128,4096]，必须为偶数。
• 默认值
  • 当 Width 和 Height 都未设置：使用输入视频的原始宽度（或长边）。
  • 当仅设置 Height：按照输入视频的原始比例来计算。