> ## Documentation Index
> Fetch the complete documentation index at: https://comfytv.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Audio Duck

> 每当有人声(或其他侧链信号)时自动压低音乐或背景轨 — 侧链压缩。

<Frame caption="Audio Duck · 截图待补">
  <img src="https://mintcdn.com/comfytv/dMkMxJDZdIo4YzAU/images/nodes/_placeholder.svg?fit=max&auto=format&n=dMkMxJDZdIo4YzAU&q=85&s=b54171099e5b02d4313fe581171ebbcc" alt="Audio Duck" width="800" height="450" data-path="images/nodes/_placeholder.svg" />
</Frame>

## 本节点的作用

**Audio Duck(音频闪避)** 根据第二条"侧链"轨来降低主轨音量,使主音频在侧链变响时自动让路。这就是经典的侧链闪避:把侧链指向你的旁白,底下的音乐在说话时自动下降,在停顿处再恢复。

主输入与侧链输入都接受 `COMFYTV_AUDIO` 快照或 `COMFYTV_VIDEO`(使用其音轨;audio 输入优先)。输出处理后的主轨 `COMFYTV_AUDIO`,并带有 ▶ **Run**(由 FFmpeg 完成)。

若要与原生 ComfyUI 的 `AUDIO` 互通,请插入 **Bridge** — 见 [bridges.md](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md)。

## 何时使用

* 让音乐床在旁白下闪避,保证解说清晰可辨。
* 每当对白响起时压低环境声或音效。
* 播客/vlog 混音,让背景轨为人声让路。

## 参数

### threshold

开始闪避的侧链电平。范围 **0.001 到 1.0**,默认 **0.05**。越低,越安静的语音也能触发。

### ratio

越过阈值后主轨被压下的力度。范围 **1 到 20**,默认 **8.0**。越大闪避越深。

### attack

侧链变响时闪避的启动速度,单位毫秒。范围 **1 到 2000**,默认 **20**。越短音乐几乎瞬间下降。

### release

侧链安静后主轨的恢复速度,单位毫秒。范围 **10 到 9000**,默认 **400**。越长恢复越平滑缓慢。

### makeup

补偿因闪避损失电平的补偿增益。范围 **1 到 8**,默认 **1.0**(不提升)。

### mix\_back

**开启**(默认)时,结果为处理后(闪避后)的主轨。此项控制是否将闪避信号混回输出。

### side\_gain

在侧链驱动闪避前施加的增益。范围 **0 到 4**,默认 **1.0**。如果安静的人声触发闪避不足,可调高。

## 输出

| 输出        | 类型              | 含义           |
| --------- | --------------- | ------------ |
| **audio** | `COMFYTV_AUDIO` | 相对侧链完成闪避后的主轨 |

## 提示

* 如果音乐出现明显"抽吸(pumping)",增大 **release** 并/或降低 **ratio**。
* 如果闪避滞后于人声,缩短 **attack**。
* 没有单独的侧链?把同一条人声轨同时接到主混音(经 **Audio Mix**)和本节点的侧链输入。

## 相关节点

* **Audio Mix** — 将闪避后的音乐与人声合成最终立体声混音。
* **Audio Crossfade** — 顺序衔接两段,而非把一段压在另一段之下。