Fuchsia.audio.effects

1

此输入流的格式。 必选。

2

此输入流的缓冲区。必须提供写入权限，并且必须有足够的空间来存储 ProcessorConfiguration.max_frames_per_call。

必选。

1

此输出流的格式。 必选。

2

此输出流的缓冲区。必须提供写入权限，并且必须有足够的空间来存储 ProcessorConfiguration.max_frames_per_call。需要写入权限，以便音频系统在出现错误时（例如当处理器断开连接时）可以向输出缓冲区写入数据。

如果效果支持就地更新，则可能表示与输入缓冲区相同的内存范围。

必选。

3

如果指定，则输出信号会偏移这么多帧。 如果未指定，则为零。 请参阅 [fuchsia.audio.effects/Processor.Process] 中的说明。

4

如果指定，则输入帧 F 将影响上行到帧 F + ring_out_frames 的输出流。如果未指定，则为零。

换言之，如果给效果一个输入流包含 N 个非静默帧，后跟无限静音，该效应最多生成 N + ring_out_frames 个非静默帧，然后发出静音。

1

每个进程调用可以（可选）分为多个阶段，每个阶段都有自己的 ProcessMetrics。此字段会命名此表中所述的阶段。

2

从收到 Process 调用到返回响应的总挂钟时间。

3

在 CPU 上运行所花费的总时间。 请参阅 zx_info_task_runtime.cpu_time。

4

等待运行所花费的总时间。仅计算“就绪”时间。 请参阅 zx_info_task_runtime.queue_time。

5

处理页面故障所花费的总时长。 请参阅 zx_info_task_runtime.page_fault_time。

6

等待争用的内核锁所花费的总时间。 请参阅 zx_info_task_runtime.lock_contention_time。

1

由先前处理步骤应用于每个输入流的总增益。例如，假设音频管道的格式为“input -> ProcessorA -> ProcessorB，如果输入是具有统一振幅的正弦波，并且 ProcessorA 应用的增益为 -5.0dB，则应在调用 ProcessorB 时指定 total_applied_gain_db_per_input[0] = -5.0dB，包含 a-5.0dB 的缓冲区。

如果未指定，则每个输入的应用增益为 0 dB。

2

对每个输入流做出贡献的所有 fuchsia.media.AudioRenderUsages。对于提供的每个 AudioRenderUsage，这是一个 (1 << r) 的位掩码。例如，如果输入流包含 BACKGROUND (== 0) 和 INTERRUPTION (== 2)，则位掩码为 ((1<<0)|(1<<2)) = 0x5。

注意：改用新的 Fuchsia 媒体 API 后，此字段可能会移除。

1

此处理器的专用 FIDL 通道。 必选。

2

此处理器的所有输入流的说明。 必须至少包含一个输入。

每个输入流都可以具有不同的样本格式或通道数，但所有输入都必须具有相同的帧速率。

3

有关此处理器的所有输出流的说明。 必须至少有一个输出。

每个输出流都可以具有不同的样本格式或通道数，但所有输出都必须与输入具有相同的帧速率 - 只要帧速率不变，音效就可以执行样本格式转换和重新通道化。

4

每次调用 fuchsia.audio.effects/Processor.Process 可以处理的帧数上限。默认限制是最小输入缓冲区可以容纳的帧数。如果指定，则该上限必须小于默认上限。

5

如果指定，则对 fuchsia.audio.effects/Processor.Process 的所有调用都必须将 num_frames 设为此数值的倍数。必须小于或等于 max_frames_per_call。如果未指定，则允许指定任何块大小。

1

2

1

2

输入和输出流的数量上限。 这些边界有点随意；在实践中，在绝大多数情况下，我们预计不超过 1 个或 2 个输入和输出。

per_stage_metrics 数组的大小上限。

进程阶段名称的最大长度。