TargetAudio - 智能媒体管理

名称	类型	描述	示例值
	object	音频处理参数配置。
DisableAudio	boolean	是否禁用音频处理，取值范围如下： true：禁用，输出文件中将不包含音频流。 false（默认）：不禁用。	false
Stream	array	需要处理的源文件音频流索引号列表。空值（默认）表示处理索引号最小的音频流（第一路音频流），索引号大于 100 表示处理所有音频流。示例：`[0,1]`处理索引号为 0 和 1 的音频流；`[1]`处理索引号为 1 的音频流；`[101]`处理所有音频流。说明只处理索引号存在的音频流，索引号对应的音频流不存在时将忽略该索引号。
	integer	需要处理的音频流索引号。	0
TranscodeAudio	object	音频转码参数，空值表示禁用音频处理，输出文件中将不包含音频流。说明不推荐通过将该参数设为空值来禁用音频处理。
Codec	string	音频编码方式。取值范围如下： API 为 CreateMediaConvert 时：copy（默认），mp3，vorbis，aac，flac，ac3，opus，amr。 API 为 GenerateVideoPlaylist 时：aac（默认）。说明当该参数为 copy 时，表示将需要处理的音频流直接拷贝到输出文件，此时 TranscodeAudio 下的其余参数无效。copy 不可用于音频拼接，通常应用于转封装场景。	aac
BitrateOption	string	音频码率选项。取值范围如下： fixed：始终使用设置的目标音频码率。 adaptive：源音频码率小于设置的目标音频码率时使用源音频码率。 fall：源音频码率小于设置的目标音频码率时返回失败。默认值： API 为 CreateMediaConvert 时，默认值为 fixed。 API 为 GenerateVideoPlaylist 时，默认值为 adaptive。说明该参数需要与参数 Bitrate 一同设置。	fixed
Bitrate	integer	音频码率，与参数 Quality 互斥，单位为比特每秒（bps）。取值范围：1000~10000000。	64000
Quality	integer	音频质量，与参数 Bitrate 互斥，取值范围：0～100（值越大质量越高）。	6
SampleRateOption	string	音频采样率。取值范围如下： fixed：始终使用设置的目标音频采样率。 adaptive：源音频采样率小于设置的目标音频采样率时使用源音频采样率。 fall：源音频采样率小于设置的目标音频采样率时返回失败。默认值： API 为 CreateMediaConvert 时，默认值为 fixed。 API 为 GenerateVideoPlaylist 时，默认值为 adaptive。说明该参数需要与参数 SampleRate 一同设置。	fixed
SampleRate	integer	音频采样率。单位为赫兹（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
Channel	integer	声道数。默认保持源音频的声道数。取值范围：[1,8]。说明不同格式支持的声道数有所不同，mp3 仅支持单、双声道；ac3 最大支持 6 声道（5.1）；amr 仅支持单声道。	2
BitsPerSample	integer	音频采样位深，取值为 16 或 24。重要该参数仅在 Codec 为 flac 时有效。	16
FilterAudio	object	音频处理参数，参数 TranscodeAudio 为空时或TranscodeAudio.Codec为 copy 时，本参数无效。说明 API 为 GenerateVideoPlaylist 时不支持设置此参数。
Mixing	boolean	是否将所有音轨混合为单轨。取值范围如下： false（默认）：否。 true：是。	false

object

音频处理参数配置。

DisableAudio

boolean

是否禁用音频处理，取值范围如下：

true：禁用，输出文件中将不包含音频流。
false（默认）：不禁用。

false

Stream

array

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

示例：[0,1]处理索引号为 0 和 1 的音频流；[1]处理索引号为 1 的音频流；[101]处理所有音频流。

说明

只处理索引号存在的音频流，索引号对应的音频流不存在时将忽略该索引号。

integer

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

0

TranscodeAudio

object

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

说明

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

Codec

string

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

API 为 CreateMediaConvert 时：copy（默认），mp3，vorbis，aac，flac，ac3，opus，amr。
API 为 GenerateVideoPlaylist 时：aac（默认）。

说明

当该参数为 copy 时，表示将需要处理的音频流直接拷贝到输出文件，此时 TranscodeAudio 下的其余参数无效。copy 不可用于音频拼接，通常应用于转封装场景。

aac

BitrateOption

string

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

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

默认值：

API 为 CreateMediaConvert 时，默认值为 fixed。
API 为 GenerateVideoPlaylist 时，默认值为 adaptive。

说明

该参数需要与参数 Bitrate 一同设置。

fixed

Bitrate

integer

音频码率，与参数 Quality 互斥，单位为比特每秒（bps）。取值范围：1000~10000000。

64000

Quality

integer

音频质量，与参数 Bitrate 互斥，取值范围：0～100（值越大质量越高）。

6

SampleRateOption

string

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

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

默认值：

API 为 CreateMediaConvert 时，默认值为 fixed。
API 为 GenerateVideoPlaylist 时，默认值为 adaptive。

说明

该参数需要与参数 SampleRate 一同设置。

fixed

SampleRate

integer

音频采样率。单位为赫兹（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

Channel

integer

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

说明

不同格式支持的声道数有所不同，mp3 仅支持单、双声道；ac3 最大支持 6 声道（5.1）；amr 仅支持单声道。

2

BitsPerSample

integer

音频采样位深，取值为 16 或 24。

重要该参数仅在 Codec 为 flac 时有效。

16

FilterAudio

object

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

说明

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

Mixing

boolean

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

false（默认）：否。
true：是。

false