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

在具有可选 q 的 frequency 附近增加/减少 gain_db。

凹口

窄带被拒会严重削弱 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

水平被指定为均方根。

硬

互连采用硬线方式（将始终插入）。

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 为单位）。 此字段可以是奈奎斯特频率，例如对于单频段动态 以指定频段为全范围（连同 min_frequency）。

必填。

4

动态主处理开始后的值（受 knee_width_db)，以输入 dB 为单位。 某些信号处理（例如 input_gain 和 output_gain）不受此值的影响。

必填。

5

动态处理应用于 ABOVE 或 BELOW 阈值。

对于服务器而言是必需的。 在以下情况下，客户端不得在 SetElementState 中包含此字段： supported_controls 中未设置“DynamicsSupportedControls.THRESHOLD_TYPE”。

6

高于或低于（请参阅 threshold_type）膝盖区域部分的输入与输出 dB 比率。

必填。

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

水平类型（峰值或均方根）。 如果不包含，则表示未指定级别类型。

选填。 在以下情况下，客户端不得在 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 匹配，并且 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

处理元素的类型专用状态参数（如果包含）。

如果此处理元素被停用，并且提供了其类型特定的状态，则 类型特有状态仅供参考（例如，已停止的元素的状态， 无需提供其他取代状态信息即可重新启动）。

可选。

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

此协议中的均衡器由多个频段构建，每个频段指定 参数，以及可通过 SetElementState 更改的 EqualizerElementState。 bands 矢量的元素数决定了频段数 该处理元素支持的网络。

必填。

2

此均衡器支持的控件。

可选。

3

如果该参数包含且为 true，则可以通过 SetElementState 停用各个频段。 如果该属性为 false 或 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

增益（以 dB 为单位）。

可选，但对于 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 格式的最小增益步长，此值不能为负数，但可以为零到 0 能够传达出有效连续的一系列值。不得超过 max_gain - min_gain。 客户端可以通过 WatchElementState 调用来查询实际增益集。

必填。

1

当前增益，采用 GainType 格式。

必填。

1

指示互连当前是否已插入。

必填

2

使用 ZX_CLOCK_MONOTONIC 指示当前 plugged 状态的设置时间。 不能为负数。

必填。

1

处理元素的类型专用状态参数。

如果此处理元素被停用，并且提供了其类型特定的状态，则 类型特有状态仅供参考，例如，如果 SetElementState 启用了 停用了处理元素（提供 SettableTypeSpecificElementState），那么任何 已取代之前的信息类 SettableTypeSpecificElementState。

如果未设置，则该元素之前的 type_specific 状态将保持不变。

对于动态、均衡器、增益和供应商特定类型，则为可选。 如果包含对于任何其他元素类型，则无效。

2

如果包含，则为八位字节的不透明对象，用于交换供应商特定信息。 这样就可以将供应商专用数据发送到任何元素，而不仅仅是 VendorSpecific 类型。

可选。

3

是否启动此处理元素（如果为 false，则停止该元素）。 已停止的处理元素不提供其抽象功能。 具体而言，没有任何音频数据流经已停止的元素。

如果对应的 Element 返回的 can_stop 等于 false，则此字段 不得设置为 false。 如果未设置，则该元素之前的 started 状态将保持不变。

可选。

4

是否绕过此处理元素（如果为 false，则启用/“绕过”该元素）。 绕过的元素不会影响通过拓扑的音频流。 具体来说，音频流经元素，没有任何变化。

如果相应的 Element 包含 false 的 can_bypass，则此字段 不得设置为 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。