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 + 放大器硬件编解码器。

峰值

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

凹口

窄带拒绝使用可选的 q，会显著减弱 frequency。

LOW_CUT

使用可选的 q（也称为高通路）将增益降至 frequency 以下。

HIGH_CUT

使用可选的 q（也称为低通路）来降低高于 frequency 的增益。

LOW_SHELF

将增益降至 frequency 以下，并达到 gain_db 量，并形成平台效应。

HIGH_SHELF

将增益降至高于 frequency 时，达到 gain_db 量，并形成平台效应。

数字

处理元素增益应用于数字域。

类比

处理元素增益应用于模拟域。

混合

处理元件增益使用数字硬件和模拟硬件混合。

小数

增益，以 dB 为单位，例如 -103.0dB 或 +3.2dB。

PERCENT

以百分比形式指定的增益，例如 10.0% 或 80.5%。

峰值

水平增益已指定为峰值。

均方根

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

必选。

4

超过此值后，动态因素主要处理便开始启动的值（受 knee_width_db 限制），以输入 dB 为单位。 某些信号处理（例如 input_gain 和 output_gain）不受此值的影响。

必选。

5

系统会在阈值 ABOVE 或 BELOW 时应用动态处理。

对服务器而言是必需的。如果 supported_controls 中未设置 DynamicsSupportedControls.THRESHOLD_TYPE，则客户端不得在 SetElementState 中包含此字段。

6

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

必选。

7

膝盖区域的宽度（以输入 dB 为单位）。如果存在，则不能为负数。 如果未添加这项属性，则未指定膝盖区域的宽度。 零表示“硬”膝盖；值越大表示“软”膝部。 此膝关节以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

关联频道（也称为“关联的立体声”，适用于双声道系统）。 如果未提供此项，则未指定“关联的频道”选项。 如果为 true，则动态响应将应用于所有渠道。 如果为 false，每个渠道都有自己的动态响应。

可选。 如果 supported_controls 中未设置 DynamicsSupportedControls.LINKED_CHANNELS，则客户端不得在 SetElementState 中包含此字段。

1

每个 ID 都必须与 Dynamics.bands 中的一个 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 后，元素硬件进入完全运行模式所需的时间（以纳秒为单位）的最佳估算值。

此字段不应出现在 SetElementState state 中，因为客户端无法设置 turn_on_delay。它可以由服务器在 WatchElementState 回复中提供。

硬件可能需要一段时间才能进入完全运行模式，例如当电源状态发生变化时。如果无法接受播放或捕获初始音频样本，则必须将这种延迟考虑在内。如果未提供，则 turn_on_delay 未知。

可选。

8

如果添加了此参数，在 ElementState 将 started 从 true 更改为 false 后，驱动程序对元素硬件进入完全停用模式所需的时间（以纳秒为单位）的最佳估算值。

此字段不应出现在 SetElementState state 中，因为客户端无法设置 turn_off_delay。它可以由服务器在 WatchElementState 回复中提供。

硬件可能需要一段时间才能进入完全停用模式，例如由于电源状态发生变化。如果在停用处理元素之后无法对音频样本进行音频处理，则必须考虑这种延迟。如果不添加此属性，则关闭延迟时间未知。

可选。

1

指定端点所代表的含义。

必选。

2

插头检测功能。 必选。

1

如果包含插头检测此端点的状态。

此字段不应出现在 SetElementState state 中，因为客户端无法设置插头状态。它必须由服务器在 WatchElementState 回复中提供。

对于服务器而言是必需的。

1

此协议中的均衡器由多个频段构建，每个频段在此指定了多个参数，还指定了可通过 SetElementState 更改的 EqualizerElementState。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

增益（以 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

如果包含，可以通过 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。