VENDOR_SPECIFIC

供應商專屬。不屬於任何後續類型定義涵蓋的處理元素類型。

CONNECTION_POINT

控管管道管道的組合和轉送。

喬治亞州

增大控制，也就是音量控制。

AUTOMATIC_GAIN_CONTROL

自動增益控制。 無論輸入內容的變化情形，自動維持合適的信號層級。

AUTOMATIC_GAIN_LIMITER

自動增益上限。 自動維持低於指定層級的信號層級。 位於等級以下的高峰不會受到影響，而最高級別的高峰值則不受影響。

地貌

變更信號的動態範圍，例如動態範圍壓縮

關閉

。

DELAY

延遲。

EQUALIZER

等化器。

SAMPLE_RATE_CONVERSION

取樣率轉換。

端點

管道的啟動/結束。

RING_BUFFER

鈴聲緩衝區。 這是啟動/結束處理管道的兩種元素類型的第一種。

DAI_INTERCONNECT

數位音訊介面互連網路。 這是可啟動/結束處理管道的第二種元素。

RING_BUFFER

端點代表環形緩衝區。 環形緩衝區處理元素的 id 允許多環緩衝區拓撲 由提供 fuchsia.hardware.audio/Composite API 的驅動程式庫支援。

DAI_INTERCONNECT

端點代表數位音訊介面互連網路 例如：將 SoC 音訊子系統連線到 DAC + 擴大器硬體轉碼器。

PEAK

在 frequency 鄰近地區增加/減少 gain_db，選用 q。

通知

狹窄錶帶拒絕功能大幅影響 frequency，選用 q。

LOW_CUT

運用選用的 q，也就是高通過率，將增減幅度降至 frequency 以下。

HIGH_CUT

使用選用的 q，也就是低速傳遞，將增益幅度降低至 frequency。

LOW_SHELF

將增益降低到 frequency 以下，金額為 gain_db，具有高地效果。

HIGH_SHELF

以高原效果調低 frequency 的增益值，讓金額 gain_db。

數位

處理元素增益會在數位領域套用。

ANALOG

處理元素增益會套用至類比網域。

混合

處理元素增益會混合使用數位和類比硬體。

簡報

以 dB 為單位指定增益，例如 -103.0dB 或 +3.2dB。

比

增加幅度是以百分比表示，例如 10.0% 或 80.5%。

PEAK

「等級增加」已指定為峰值。

RMS

指定為 RMS 的等級。

困難

互連網路採用有線網路，且一律接上電源。

CAN_ASYNC_NOTIFY

互連網路可能處於拔除插頭/插頭的狀態，並且能以非同步方式通知插座狀態變更。

ABOVE

套用高於門檻的動態處理方法。

低於

套用低於門檻的動態處理方法。

1

插電偵測功能。

必填。

1

這個 DAI 互連網路的插頭狀態。

必填。

2

從這個 DAI 端點之後，驅動程式的最佳外部延遲時間估計值，因為 目前已設定。

用戶端在確定需求時必須將 external_delay 納入考量 至少前置時間 (播放時) 和最短拍攝延遲時間 (拍攝時)。

如果未包含，external_delay 表示不明；客戶可能會選擇採用 (例如視為 0 或其他其他時間長度、自動偵測等)。

選用。

1

這個通訊協定中的 Dynamics 元素可能支援多個頻帶， 指定 DynamicsElementState 中可以變更的幾個參數 搭配 SetElementState。 bands 向量的元素數量會決定支援的頻帶數量 這個處理元素

此為必要項目。至少須包含一個項目。

2

此處理元素支援的控制項。

選用。

1

此錶帶的專屬 ID，只需在對應的 Element，有效期限至與「SignalProcessing」相關聯的管道 因此這個階段是封閉式通訊協定

必填。

1

錶帶的專屬 ID。必須與以下項目中指定的其中一個 id 相符： Dynamics bands。

2

錶帶的最小頻率 (以 Hz 為單位)。 舉例來說，這個欄位可以是 0，例如用於單頻動態處理需指定 (連同 max_frequency 一起) 表示錶帶的完整範圍。

3

錶帶的最大頻率 (以 Hz 為單位)。 這個欄位可以是 Nyquist 頻率，例如單頻動態。 處理程序，指定錶帶的完整範圍 (搭配 min_frequency)。

必填。

4

動態主處理程序開始後的值 (取決於 knee_width_db)，在輸入 dB 中。 input_gain 和 output_gain 等部分信號處理程序不會受到這個值影響。

必填。

5

動態處理功能已套用 ABOVE 或 BELOW 門檻。

伺服器需要。 如果發生以下情況，用戶端不得在 SetElementState 中加入這個欄位 未在「supported_controls」中設定「DynamicsSupportedControls.THRESHOLD_TYPE」。

6

輸入與輸出 dB 的比率高於或低於膝蓋區域 (請參閱 threshold_type)。

必填。

7

膝蓋區域的寬度，輸入 dB。如果有 ，就不能為負數。 如果未指定，則未指定膝蓋區域的寬度。 值為 0 代表「硬性」膝蓋；輸入的值會使「較不穩定」膝蓋。 這隻膝蓋位於threshold_db的中心。

選用。 如果發生以下情況，用戶端不得在 SetElementState 中加入這個欄位 未在「supported_controls」中設定「DynamicsSupportedControls.KNEE_WIDTH」。

8

攻擊時間。 如果沒有提供，則未指定攻擊時間。

選用。 如果發生以下情況，用戶端不得在 SetElementState 中加入這個欄位 未在「supported_controls」中設定「DynamicsSupportedControls.ATTACK」。

9

發布時間。 如未提供，則未指定發布時間。

選用。 如果發生以下情況，用戶端不得在 SetElementState 中加入這個欄位 未在「supported_controls」中設定「DynamicsSupportedControls.RELEASE」。

10

以 dB 為單位的輸出內容 (也就是化妝或後期) 增益值。 如未納入，則未指定輸出增益值。

選用。 如果發生以下情況，用戶端不得在 SetElementState 中加入這個欄位 未在「supported_controls」中設定「DynamicsSupportedControls.OUTPUT_GAIN」。

11

以 dB 為單位增加輸入量 如果未指定，則未指定輸入的增益值。

選用。 如果發生以下情況，用戶端不得在 SetElementState 中加入這個欄位 未在「supported_controls」中設定「DynamicsSupportedControls.INPUT_GAIN」。

12

等級類型 (最高值或 RMS)。 如未提供，則未指定等級類型。

選用。 如果發生以下情況，用戶端不得在 SetElementState 中加入這個欄位 未在「supported_controls」中設定「DynamicsSupportedControls.LEVEL_TYPE」。

13

預先評估時間。 如果沒有加入，則未指定預先考慮時間。

選用。 如果發生以下情況，用戶端不得在 SetElementState 中加入這個欄位 未在「supported_controls」中設定「DynamicsSupportedControls.LOOKAHEAD」。

14

已連結的頻道 (也就是與雙管道系統連結的立體聲)。 如果沒有加入，則表示未指定連結頻道。 如果設為 true，動態回應會套用至所有管道。 如果為 false，則每個管道都有自己的動態回應。

選用。 如果發生以下情況，用戶端不得在 SetElementState 中加入這個欄位 未在「supported_controls」中設定「DynamicsSupportedControls.LINKED_CHANNELS」。

1

每個 ID 都必須與 Dynamics.bands 的 ID 相符，且不得重複。 「band_states」必須至少包含一個元素。 band_states 控制的錶帶由各band.id決定。

1

此元素的專屬 ID。這個 ID 的範圍僅在 SignalProcessing 中 通訊協定效期，也就是與通訊協定相關聯的管道關閉為止。

必填。

2

正在處理元素類型。

必填。

3

如果包含在內，系統就會處理處理元素的類型專屬參數。

選用。

4

如果加入且值為 True，就可以透過以下方式停用處理元素： ElementSetState。 如果不包含或否，系統會一律啟用處理元素。

選用。

淘汰

請改用 can_bypass。

5

如有這類標記，則會顯示處理元素的文字說明。

選用。

6

如果加入且為 True，即可透過 ElementSetState 停止處理元素。 如果不包含或否，系統會一律啟動處理元素。

選用。

7

如果加入且為 True，就能透過 ElementSetState 略過處理元素。 如果不包含或設為 False，就無法略過處理元素。

選用。

1

如果有提供，就會為處理元素指定類型專屬的狀態參數。

如果這個處理元素已停用，且提供了其類型專屬狀態，那麼 類型專屬狀態只是資訊 (例如當停止元素的狀態 重新啟動，而不必提供其他取代狀態資訊)。

選用。

2

處理元素啟用/停用狀態。系統預設會啟用處理元素。 如果對應的 Element 傳回 can_disable 等於 false，則 這個欄位無法設為「false」。 如果未包含 enabled，則必須納入 state，而且只在處理時 元素目前已啟用。

選用。

淘汰

請改用 bypassed。

3

如果包含在內，當這個處理元素發生時，管道會增加多少延遲時間 這個欄位不得出現在 SetElementState state 中，因為 延遲時間無法由用戶端設定，只能由位於 WatchElementState 則回覆。

選用。

4

如有包含，這是用來交換供應商特定資訊的不透明八位元物件。

選用。

5

這個處理元素的啟動/停止狀態。 如果為 true，系統會啟動與該元素相關聯的硬體。如果為 false，表示已停止。

根據預設，系統會啟動處理元素。

停止處理的元素並不提供抽象的功能。 具體來說，沒有任何音訊資料透過停止的元素傳輸。

必填。

6

這個處理元素的略過狀態。 如為 true，系統會略過與元素相關聯的硬體。如果為 false，則不會略過。

根據預設，系統不會略過預設的處理元素。 如果對應的 Element 傳回 can_bypass 等於 false，則 這個欄位無法設為「true」。

略過的元素不會影響拓撲間的音訊流動。

選用。

7

如果納入這項屬性，則代表驅動程式庫準確預估元素 started 從 false 變更為 true 之後，才進入完整運作模式。 變更 電源狀態

如未考量這段延遲時間，音訊串流的初始影格 音訊元素啟動期間遺失。 如果沒有加入，表示 turn_on_delay 不明。

選用。

8

如果納入這項屬性，則代表驅動程式庫準確預估元素 started 從 true 變更為 false 後，藉此進入完全停用模式。 變更 電源狀態

如果沒有考量這項延遲，發出/擷取的影格數量會超過 尤其是當某些元件關閉時，客戶可能會發現。 如果沒有加入，表示 turn_off_delay 不明。

選用。

9

如有加入，則該驅動程式庫的最佳預估結果 (根據目前設定，包括 bypassed 個) 此處理元素增加的延遲時間

客戶判斷 最短前置時間 (播放時) 和最短拍攝延遲時間 (拍攝時)。

針對 RING_BUFFER 類型的元素，此延遲時間不應包含固有延遲時間 加入暫時性緩衝設定，以在環形緩衝區中複製資料，或從環形緩衝區複製資料。 包含在 RingBufferProperties 欄位中 driver_transfer_bytes。

選用。

1

指定端點代表的內容，

必填。

2

插電偵測功能。 必填。

1

如果納入這個端點的插座偵測狀態，

伺服器需要。

1

這個通訊協定中的等化器是由多個色彩模式所構成，每個頻段都會指定 和 EqualizerElementState 可用 SetElementState 變更。 bands 向量的元素數量會決定色彩模式數量 該處理元素所提供的支援。

必填。

2

這個等化器支援的控制項。

選用。

3

如果納入此範圍且為 true，則可透過 SetElementState 停用個別錶帶。 如果未包含或未包含 false，則錶帶會一直啟用。 必須啟用錶帶所含等化器處理元素，錶帶才能正常運作。

選用。

4

錶帶的最小頻率 (以 Hz 為單位)。

必填。

5

錶帶的最大頻率 (以 Hz 為單位)。

必填。

6

最大品質因素，通常以「Q」表示。 用於表示頻率轉換的頻率有多長。Q 值越高，表示越窄 凹槽/高音以及燉切/剪接頭。必須為正數。

選用。

7

最小增益值 (以 dB 為單位)。

選用，但如果 supported_controls 存在且包含 SUPPORTS_TYPE_PEAK，則為必要； SUPPORTS_TYPE_LOW_SHELF或SUPPORTS_TYPE_HIGH_SHELF。

8

最大增值 (dB)。

選用，但如果 supported_controls 存在且包含 SUPPORTS_TYPE_PEAK，則為必要； SUPPORTS_TYPE_LOW_SHELF或SUPPORTS_TYPE_HIGH_SHELF。

1

此錶帶的專屬 ID，只需在對應的 Element，有效期限至與「SignalProcessing」相關聯的管道 因此這個階段是封閉式通訊協定

必填。

1

錶帶的專屬 ID。必須與 Equalizer bands 中指定的其中一個 id 相符。

必填。

2

錶帶類型。

選用。

3

錶帶的中心頻率。

選用。

4

品質因素，通常以「Q」表示。 用於表示頻率轉換的頻率有多長。Q 值越高，表示越窄 凹槽/高音以及燉切/剪接頭。必須為正數。

選用。

5

增加 分貝。

選填，但 EqualizerBandType PEAK、LOW_SHELF 和 HIGH_SHELF 為必填。 可能不包含在 EqualizerBandType NOTCH、LOW_CUT 或 HIGH_CUT 的情況下。

6

啟用/停用錶帶。系統預設會啟用所有頻帶。 將 ElementState.enabled 設為 false 會停用整個等化器，且不會變更這個欄位。配戴 必須啟用該容器內含的等化器處理元素。

選用。

1

bands_state 向量的元素數量必須等於或小於 傳回的 bands 元素數量 Equalizer。「bands_state」必須至少包含一個元素。 bands_state 控制的錶帶由各band.id決定。

必填。

2

band_states 向量的元素數量必須等於或小於 傳回的 bands 元素數量 Equalizer。「band_states」必須至少包含一個元素。 band_states 控制的錶帶由各band.id決定。

必填。

1

指定增益數字代表的意義，例如百分比。

必填。

2

如果包含，則會套用在指定 GainDomain 中。 如果不包含，則未指定取得網域。

選用。

3

最小增益，格式為 GainType。

必填。

4

最大增益，採用 GainType 格式。

必填。

5

採用 GainType 格式的最小增益步驟，這個值不得為負數，但可以是零至 傳達一個有效連續的值範圍不得超過 max_gain 至 min_gain。 用戶端可以透過 WatchElementState 呼叫查詢實際的增益集。

必填。

1

目前漲幅 (GainType)，

必填。

1

指出互連網路目前是否插入。

必要

2

表示使用 ZX_CLOCK_MONOTONIC 設定目前 plugged 狀態的時間。 不得為負值。

必填。

1

處理元素的類型專屬狀態參數。

如果這個處理元素已停用，且提供了其類型專屬狀態，那麼 類型專屬狀態只是資訊，例如 SetElementState 啟用 已停用提供 SettableTypeSpecificElementState 的處理元素 之前提供資訊的 SettableTypeSpecificElementState 將被取代。

如未設定，元素先前的 type_specific 狀態會維持不變。

對動態、等化器、獲利以及供應商特定類型而言則為選用。 如果加入任何其他元素類型，則無效。

2

如有包含，這是用來交換供應商特定資訊的不透明八位元物件。 系統可能會將供應商專屬資料傳送至任何元素，而不只是供應商專屬類型。

選用。

3

是否啟動這個處理元素 (如為 false，則停止)。 停止處理的元素並不提供抽象的功能。 具體來說，沒有任何音訊資料透過停止的元素傳輸。

如果對應的 Element 傳回 can_stop 等於 false，則這個欄位 不得設為 false。 如未設定，元素先前的 started 狀態會維持不變。

選用。

4

是否略過這個處理元素 (如果為 false，則啟用/「略過」。 略過的元素不會影響拓撲間的音訊流動。 具體來說，音訊會透過元素傳遞，且不會有任何變化。

如果對應的 Element 包含 can_bypass 為 false，則這個欄位 不得設為 true。 如未設定，元素先前的 bypassed 狀態會維持不變。

選用。

1

這個拓撲的專屬 ID。這個 ID 的範圍僅在 SignalProcessing 中 通訊協定效期，也就是與通訊協定相關聯的管道關閉為止。

必填。

2

依序處理元素邊緣配對的向量。 邊緣組合形式管道的處理元素順序。 如要定義多個可能的管道，請在 GetTopologies 中傳回更多 Topology 項目。

必填。

1

延遲時間已新增為 zx.Duration 管道的延遲時間。

2

以影格數的形式新增至管道的延遲時間。

1

2

1

2

1

2

3

4

1

2

1

2

1

2

3

4

5

6

1

2

3

4

5

6

KNEE_WIDTH

如果採用此選項，則可變更 knee_width_db 參數。

攻擊

如果採用此選項，則可變更 attack 參數。

發布

如果採用此選項，則可變更 release 參數。

OUTPUT_GAIN

如果採用此選項，則可變更 output_gain_db 參數。

INPUT_GAIN

如果採用此選項，則可變更 input_gain_db 參數。

看起來

如果採用此選項，則可變更 lookahead 參數。

LEVEL_TYPE

如果採用此選項，則可變更 level_type 參數。

LINKED_CHANNELS

如果採用此選項，則可變更 linked_channels 參數。

THRESHOLD_TYPE

如果採用此選項，則可變更 threshold_type 參數。

CAN_CONTROL_FREQUENCY

如果加入，則可使用 SetElementState 變更等化器錶帶的 frequency。

CAN_CONTROL_Q

如果加入，則可使用 SetElementState 變更等化器錶帶的 q。

SUPPORTS_TYPE_PEAK

如果加入，則可使用 SetElementState 變更等化器錶帶的 type 至 EqualizerBandType PEAK。

SUPPORTS_TYPE_NOTCH

如果加入，則可使用 SetElementState 變更等化器錶帶的 type 至 EqualizerBandType NOTCH。

SUPPORTS_TYPE_LOW_CUT

如果加入，則可使用 SetElementState 變更等化器錶帶的 type 至 EqualizerBandType LOW_CUT。

SUPPORTS_TYPE_HIGH_CUT

如果加入，則可使用 SetElementState 變更等化器錶帶的 type 至 EqualizerBandType HIGH_CUT。

SUPPORTS_TYPE_LOW_SHELF

如果加入，則可使用 SetElementState 變更等化器錶帶的 type 至 EqualizerBandType LOW_SHELF。

SUPPORTS_TYPE_HIGH_SHELF

如果加入，則可使用 SetElementState 變更等化器錶帶的 type 至 EqualizerBandType HIGH_SHELF。