TargetAudio資料結構參數詳解-Intelligent Media Management-阿里雲

名稱	類型	描述	樣本值
	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