aec3-rs：把 WebRTC 的 AEC3 回声消除器搬进 Rust 生态
内容提要
aec3-rs 是 WebRTC AEC3 回声消除器的 Rust 移植，将 AEC3、NS、AGC2 等模块统一到带类型检查的有向图运行时，支持声明式接线、异步到达与节点生命周期控制。v0.4.0 新增多声道检测、前置回声检测和全带后置滤波，并提供 SIMD 实测数据。项目采用 MIT 或 BSD-3-Clause 许可，可商用，适合 Rust 端侧语音链路开发。
延伸解读
图运行时带来的工程收益
aec3-rs 将 AEC3 等模块统一到带类型检查的有向图运行时，支持声明式接线、异步到达和节点生命周期控制。这解决了传统 process(render, capture) 接口难以灵活组合的问题，例如在 AEC 后接 NS、旁路分析或动态开关节点。类型化端口让接线错误在编译期暴露，严格的对齐语义避免了静默降级，对构建复杂语音链路的团队很有价值。
v0.4.0 新增能力与性能
v0.4.0 补齐了多声道检测、前置回声检测和全带后置滤波，并提供了 SIMD 加速后的实测数据。新增的 capture_output_used_in 端口允许在采集输出无人使用时跳过残余回声估计等计算，同时保持线性滤波器自适应，从而节省算力而不影响收敛。这些改进提升了实用性和性能，但具体数据需参考项目文档。
商用许可与专利边界
项目采用 MIT 或 BSD-3-Clause 双许可，可自由商用。但需注意 PATENT 文件中的额外专利授权：Google 授予的专利许可仅覆盖本实现必然侵权的权利要求，若进行大幅修改，则可能超出授权范围。此外，若发起专利诉讼，授权将终止。因此，直接使用原样代码风险较低，修改后需自行评估。
适用场景与当前限制
aec3-rs 适合在 Rust 生态中开发端侧 RTC、会议客户端、语音智能体等，尤其需要自定义 DSP 或动态开关节点的场景。但项目仍为 WIP，图 API 自 v0.2 起引入且预期继续演进，生产使用建议锁版本。若不需要图模型，可直接使用底层 audio_processing 模块。项目完整移植了 WebRTC 参考实现，便于对照验证。
Q&A
aec3-rs 是什么？它和 WebRTC 的 AEC3 有什么关系？
aec3-rs 是 WebRTC AEC3 声学回声消除器的 Rust 移植版本，由 RubyBit 开发。它不只是简单翻译 C++ 代码，而是将 AEC3 与 NS、AGC2、HPF、重采样等模块统一到一个带类型检查的有向图运行时中，让端侧语音链路的搭建从函数顺序调用变为声明式接线。
aec3-rs 的图运行时有什么特别之处？
aec3-rs 从 v0.2 开始采用 DAG 执行模型，支持泛型类型化端口（编译期检查接线错误）、异步到达（render/capture/control 三类 packet 独立到达）、零拷贝倾向、两种调度风格（OnArrival 和 AlignOn）、严格的对齐语义（BySequence 要求序列号一致）以及节点生命周期控制（Active/Bypassed/Suspended 三种状态和重置能力）。
aec3-rs 的 AEC3 节点有哪些可选端口和功能？
AEC3 节点提供线性输出（linear-output，用于旁路分析）、指标（metrics）、诊断（diagnostics，配合 diagnostics feature 与 parse-diagnostics 工具）、延迟控制，以及 v0.4 新增的 capture_output_used_in 端口。该端口允许在采集输出无人使用时跳过残余回声估计、抑制增益计算和抑制滤波，采集块原样透传，同时线性滤波器继续自适应。
aec3-rs 可以商用吗？许可证和专利情况如何？
可以商用。Cargo.toml 中声明为 MIT OR BSD-3-Clause 双许可任选。仓库根目录的 PATENT 文件沿用 Google 对 WebRTC 的 Additional IP Rights Grant，授予永久、全球、非独占、免费、不可撤销的专利许可，但仅限本实现必然侵权的权利要求，不包括进一步修改才侵权的部分。若对任何实体发起主张本实现构成专利侵权的诉讼，许可自起诉之日起终止。
aec3-rs 适合哪些场景？有哪些限制？
适合在 Rust 生态中做端侧 RTC、会议客户端、语音智能体、对讲设备的团队，以及需要在 AEC 前后插入自定义 DSP 或动态开关处理节点的产品，也适合想复用 NS、AGC2、重采样等 WebRTC 音频组件的项目。限制包括：项目自我定位为 WIP，图 API 从 v0.2 起才存在且预期继续演进，生产使用建议锁版本；如果不需要图模型，可直接使用底层模块。
如何使用 aec3-rs 搭建标准语音链路？
可以使用 aec3::pipelines::linear，它封装了 render + capture -> HPF -> AEC3 -> NS -> AGC2 的标准链路。示例代码中创建 AudioFormat::ten_ms(48_000, 1)，通过 linear::builder 设置 initial_delay_ms(116) 和 export_metrics(true) 后 build，然后调用 handle_render_frame 和 process_capture_frame 处理音频。该 wrapper 会自动给 packet 打序列号，下游用 BySequence 对齐的节点可直接工作。
