文档

TargetAudio

更新时间:
名称类型描述示例值
object

音频处理参数配置。

DisableAudioboolean

是否禁用音频处理,取值范围如下:

  • true:禁用,输出文件中将不包含音频流。
  • false(默认):不禁用。
false
Streamarray

需要处理的源文件音频流索引号列表。空值(默认)表示处理索引号最小的音频流(第一路音频流),索引号大于 100 表示处理所有音频流。

  • 示例:[0,1]处理索引号为 0 和 1 的音频流;[1]处理索引号为 1 的音频流;[101]处理所有音频流。
说明 只处理索引号存在的音频流,索引号对应的音频流不存在时将忽略该索引号。
long

需要处理的音频流索引号。

0
TranscodeAudioobject

音频转码参数,空值表示禁用音频处理,输出文件中将不包含音频流。

说明 不推荐通过将该参数设为空值来禁用音频处理。
Codecstring

音频编码方式。取值范围如下:

  • API 为 CreateMediaConvert 时:copy(默认),mp3,vorbis,aac,flac,ac3,opus,amr。
  • API 为 GenerateVideoPlaylist 时:aac(默认)。
说明 当该参数为 copy 时,表示将需要处理的音频流直接拷贝到输出文件,此时 TranscodeAudio 下的其余参数无效。copy 不可用于音频拼接,通常应用于转封装场景。
aac
BitrateOptionstring

音频码率选项。取值范围如下:

  • fixed:始终使用设置的目标音频码率。
  • adaptive:源音频码率小于设置的目标音频码率时使用源音频码率。
  • fall:源音频码率小于设置的目标音频码率时返回失败。

默认值:

  • API 为 CreateMediaConvert 时,默认值为 fixed。
  • API 为 GenerateVideoPlaylist 时,默认值为 adaptive。
说明 该参数需要与参数 Bitrate 一同设置。
fixed
Bitrateinteger

音频码率,与参数 Quality 互斥,单位为比特每秒(bps)。取值范围:1000~10000000。

64000
Qualityinteger

音频质量,与参数 Bitrate 互斥,取值范围:0~100(值越大质量越高)。

6
SampleRateOptionstring

音频采样率。取值范围如下:

  • fixed:始终使用设置的目标音频采样率。
  • adaptive:源音频采样率小于设置的目标音频采样率时使用源音频采样率。
  • fall:源音频采样率小于设置的目标音频采样率时返回失败。

默认值:

  • API 为 CreateMediaConvert 时,默认值为 fixed。
  • API 为 GenerateVideoPlaylist 时,默认值为 adaptive。
说明 该参数需要与参数 SampleRate 一同设置。
fixed
SampleRateinteger

音频采样率。单位为赫兹(Hz)。默认保持源音频的采样频率,取值范围:8000、12025、12000,16000、22050、24000,32000、44100、48000、64000、88200 和 96000。

说明 不同格式支持的采样率有所不同,mp3 仅支持 48kHz 及以下;opus 支持 8kHz、12kHz、16kHz、24kHz 与 48kHz;ac3 支持 32kHz、44.1kHz 与 48kHz;amr 仅支持 8kHz 与 16kHz。
12050
Channelinteger

声道数。默认保持源音频的声道数。取值范围:[1,8]。

说明 不同格式支持的声道数有所不同,mp3 仅支持单、双声道;ac3 最大支持 6 声道(5.1);amr 仅支持单声道。
2
FilterAudioobject

音频处理参数,参数 TranscodeAudio 为空时或TranscodeAudio.Codec为 copy 时,本参数无效。

说明 API 为 GenerateVideoPlaylist 时不支持设置此参数。
Mixingboolean

是否将所有音轨混合为单轨。取值范围如下:

  • false(默认):否。

  • true:是。

false