VENDOR_SPECIFIC

供應商特定資訊。任何後續類型定義未涵蓋的處理元素類型。

CONNECTION_POINT

控制管道通道的混合和轉送。

喬治亞

增強控制項，以及音量控制項。

AUTOMATIC_GAIN_CONTROL

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

AUTOMATIC_GAIN_LIMITER

自動增益限制器。自動維持低於指定等級的信號等級。位於層級以下的輸入則不受影響，且高於等級的峰值。

動態

修改信號的動態範圍，例如動態範圍壓縮。

關閉

。

DELAY

延遲。

等化

等化器。

SAMPLE_RATE_CONVERSION

取樣率轉換。

ENDPOINT

管道的開始/結束。

RING_BUFFER

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

DAI_INTERCONNECT

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

峰值

增加/減少 gain_db (在 frequency 附近可達 q 的情況下)。

標記

拒絕狹窄的錶帶，大幅重視 frequency 加上選用的 q。

LOW_CUT

如要降低低於 frequency，選用 q (即高通過) 的升幅。

HIGH_CUT

使用 q (選用) 較低的通道，將升幅降低到超過 frequency 以上。

LOW_SHELF

以高強度效果將增減 gain_db 以下，金額降至 frequency。

HIGH_SHELF

以高強度效果將增減 gain_db 提高到 frequency 以上。

數位

處理元素增益同樣適用於數位領域。

ANALOG

處理元素增益集會在類比網域中套用。

混合

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

決策

分貝中指定的漲幅，例如 -103.0dB 或 +3.2dB。

PERCENT

獲利金額是以百分比表示，例如 10.0% 或 80.5%。

峰值

等級增益處以峰值表示。

RMS

指定為 RMS 的等級。

軟硬體

端點採用有線連接 (一律連接)。

CAN_ASYNC_NOTIFY

端點可能未接上電源並插上插頭，並以非同步方式通知插座狀態異動。

前行

在高於門檻的情況下套用動態處理程序。

下方

套用低於門檻的動態處理程序。

1

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

此為必要項目。至少要有一個項目。

2

這個處理元素支援的控制項。

選用。

1

這個錶帶的專屬 ID，在對應的 Element 中不得重複，而且在與 SignalProcessing 通訊協定相關聯的管道關閉前有效。

必填。

1

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

2

錶帶的最小頻率 (以 Hz 為單位)。如果是單一頻帶動態處理，則此欄位可以是 0，藉此指定錶帶全範圍 (和 max_frequency)。

3

錶帶的最大頻率 (以 Hz 為單位)。這個欄位可以是 Nyquist 頻率，舉例來說，如果是單一頻帶動態處理，進而指定錶帶位於整個範圍 (加上 min_frequency 設定) 值即可。

必填。

4

輸入 dB 中，動態主要處理開始超出的值 (取決於 knee_width_db)。這個值不會影響部分信號處理程序 (例如 input_gain 和 output_gain)。

必填。

5

動態處理程序已套用於 ABOVE 或 BELOW。

伺服器必填。 如未在 supported_controls 中設定 DynamicsSupportedControls.THRESHOLD_TYPE，用戶端就不得在 SetElementState 中加入這個欄位。

6

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

必填。

7

膝蓋區域的寬度，以輸入的 dB 表示。如果有值，則不能為負數。如未加入，則不會指定膝蓋區域的寬度。值為 0 是「硬度」膝蓋；數值越大，則代表「柔軟」膝蓋。 這支膝蓋位於threshold_db。

選用。 如未在 supported_controls 中設定 DynamicsSupportedControls.KNEE_WIDTH，用戶端就不得在 SetElementState 中加入這個欄位。

8

攻擊時間。如未納入，就不會指定攻擊時間。

選用。 如未在 supported_controls 中設定 DynamicsSupportedControls.ATTACK，用戶端就不得在 SetElementState 中加入這個欄位。

9

發布時間。如未加入，則會未指定推出時間。

選用。 如未在 supported_controls 中設定 DynamicsSupportedControls.RELEASE，用戶端就不得在 SetElementState 中加入這個欄位。

10

dB 中的輸出 (即構成或後置) 增值。如未納入，就不會指定輸出增益。

選用。 如未在 supported_controls 中設定 DynamicsSupportedControls.OUTPUT_GAIN，用戶端就不得在 SetElementState 中加入這個欄位。

11

輸入 (又稱為預先) 增補 dB 值。如果未包含，就不會指明輸入增益。

選用。 如未在 supported_controls 中設定 DynamicsSupportedControls.INPUT_GAIN，用戶端就不得在 SetElementState 中加入這個欄位。

12

等級類型 (峰值或 RMS)。如未加入，則表示未指定等級類型。

選用。 如未在 supported_controls 中設定 DynamicsSupportedControls.LEVEL_TYPE，用戶端就不得在 SetElementState 中加入這個欄位。

13

預先公布時間。 如果未指定，則會未指定提前時間。

選用。 如未在 supported_controls 中設定 DynamicsSupportedControls.LOOKAHEAD，用戶端就不得在 SetElementState 中加入這個欄位。

14

連結的頻道 (即適用於 2 個管道系統的立體聲頻道)。 如未加入，就不會指定已連結頻道選項。如果為 true，動態回應會套用至所有管道。 如果設為 false，每個管道都有各自的動態回應。

選用。 如未在 supported_controls 中設定 DynamicsSupportedControls.LINKED_CHANNELS，用戶端就不得在 SetElementState 中加入這個欄位。

1

每個 ID 都必須與 Dynamics.bands 中的 ID 相符，且 ID 不得重複。band_states 至少必須包含一個元素。band_states 控制的頻帶取決於每個 band.id。

1

此元素的專屬 ID。這個 ID 的範圍只在 SignalProcessing 通訊協定效期內 (即到與通訊協定相關聯的管道關閉為止)。

必填。

2

正在處理元素類型。

必填。

3

如果一併納入，表示處理元素的類型特定參數。

選用。

4

如果包含屬性和 true，您可以透過 ElementSetState 停用處理元素。如果沒有加入或設為 false，系統一律會啟用處理元素。

選用。

淘汰

請改用 can_bypass。

5

如果有處理元素，請提供處理元素的文字說明。

選用。

6

如果包含 和 true，可以透過 ElementSetState 停止處理元素。如果沒有加入或設為 false，系統一律會啟動處理元素。

選用。

7

如果屬性包含 且為 true，就可以透過 ElementSetState 略過處理元素。如果未指定 或 false，則無法略過處理元素。

選用。

1

如果納入，表示處理元素的特定類型狀態參數。

如果停用這個處理元素，且提供了類型專屬的狀態，則類型專屬狀態只會提供資訊。舉例來說，如果 SetElementState 啟用提供 TypeSpecificElementState 的已停用處理元素，則任何先前的資訊 TypeSpecificElementState 都會遭到取代。

選用。

2

處理元素啟用/停用狀態。選用。根據預設，系統會啟用處理元素。如果對應的 Element 回傳 can_disable 等於 false，則這個欄位不得設為 false。如果未包含 enabled，則只有在目前已啟用處理元素時，才需要加入 state。

選用。

淘汰

請改用 bypassed。

3

如果啟用這個處理元素，則管道會增加多少延遲時間。這個欄位不得出現在 SetElementState state 中，因為用戶端無法設定延遲時間，只能由伺服器在 WatchElementState 回覆中提供。

選用。

4

如果包含，用來交換供應商特定資訊的不透明物件。

選用。

5

這個處理元素的開始/停止狀態。設為 true 時，表示與元素相關聯的硬體已啟動。如果為 false，則停止。

系統預設會啟動處理元素。如果對應的 Element 回傳 can_stop 等於 false，則這個欄位不得設為 false。

停止處理元素不提供其抽像功能。具體而言，系統不會透過已停止的元素傳輸音訊資料。

必填。

6

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

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

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

選用。

7

如果納入此屬性，驅動程式庫最好在 started 從 false 變更為 true 後，元素硬體進入完整運作模式所需的時間 (以奈秒為單位) 的最佳預估時間。

由於 turn_on_delay 無法由用戶端設定，因此 SetElementState state 中不應包含這個欄位。伺服器可能會在 WatchElementState 回覆中提供此名稱。

硬體可能需要一段時間才能進入完整運作模式，例如電源狀態變更所致。如果系統不接受播放或擷取的初始音訊樣本，則必須將這類延遲納入考量。如未加入，turn_on_delay 就不會出現。

選用。

8

如果納入此屬性，驅動程式庫在 ElementState 將 started 從 true 變更為 false 後，元素硬體進入完全停用模式所需的時間 (以奈秒為單位) 最佳預估時間。

由於 turn_off_delay 無法由用戶端設定，因此 SetElementState state 中不應包含這個欄位。伺服器可能會在 WatchElementState 回覆中提供此名稱。

硬體可能需要一段時間才能進入完全停用模式，例如因為電源狀態變更。如果停用處理元素後，系統不接受音訊樣本處理音訊，就必須將這類延遲時間納入考量。如果未包含在內，表示關閉延遲時間不明。

選用。

1

指定端點所代表的意義。

必填。

2

插頭偵測功能。 必填。

1

如果包含插頭的此端點偵測狀態。

這個欄位不應在 SetElementState state 中顯示，因為用戶端無法設定插頭狀態。這項資訊必須由伺服器在 WatchElementState 回覆中提供。

伺服器必填。

1

這個通訊協定中的等化器是由多個頻帶建構而成，每個頻帶都指定幾個參數，以及可以用 SetElementState 變更的 EqualizerElementState。bands 向量的元素數量會決定這個處理元素支援的頻帶數量。

必填。

2

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

選用。

3

如果包括隨附的 及 True，可以透過 SetElementState 停用個別錶帶。如果未納入或不提供，則一律會啟用錶帶。如要讓錶帶能運作，必須啟用其外圍等化器處理元素。

選用。

4

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

必填。

5

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

必填。

6

錶帶的最高品質因素 (通常以「Q」表示)。表示頻率轉換的範圍越小。Q 值越大，代表凹槽/峰值和剪裁/影片櫃越窄。必須為正數。

選用。

7

分貝最低增值。

這是選用元素，但如果 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

增減 dB。

這是選用元素，但 EqualizerBandType PEAK、LOW_SHELF 和 HIGH_SHELF 為必要欄位。可能不會包含在 EqualizerBandType NOTCH、LOW_CUT 或 HIGH_CUT 中。

6

啟用/停用錶帶。所有錶帶都會預設為啟用。將 ElementState.enabled 設為 false 來停用封閉處理元素，會停用整個等化器，也不會變更這個欄位。如要讓錶帶能正常運作，必須啟用其外圍等化器處理元素。

選用。

2

band_states 向量的元素數量必須等於或小於對應 Equalizer 中傳回的 bands 元素數量。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)，這是這個資料表其他欄位中提供的資訊。指出這個表格描述的轉換時間。

必填。

1

這個拓撲的專屬 ID。這個 ID 的範圍只在 SignalProcessing 通訊協定效期內 (即到與通訊協定相關聯的管道關閉為止)。

必填。

2

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

必填。

1

以 zx.Duration 的形式新增至管道的延遲時間。

2

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

1

2

1

2

1

2

1

2

1

2

3

4

5

1

2

3

4

5

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

如果包含等化器頻帶的 type，則可使用 SetElementState 變更為 EqualizerBandType PEAK。

SUPPORTS_TYPE_NOTCH

如果包含等化器頻帶的 type，則可使用 SetElementState 變更為 EqualizerBandType NOTCH。

SUPPORTS_TYPE_LOW_CUT

如果包含等化器頻帶的 type，則可使用 SetElementState 變更為 EqualizerBandType LOW_CUT。

SUPPORTS_TYPE_HIGH_CUT

如果包含等化器頻帶的 type，則可使用 SetElementState 變更為 EqualizerBandType HIGH_CUT。

SUPPORTS_TYPE_LOW_SHELF

如果包含等化器頻帶的 type，則可使用 SetElementState 變更為 EqualizerBandType LOW_SHELF。

SUPPORTS_TYPE_HIGH_SHELF

如果包含等化器頻帶的 type，則可使用 SetElementState 變更為 EqualizerBandType HIGH_SHELF。