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

# 视频音量 (Video Volume)

> 调整片段的音量，并在开头/结尾加淡入、淡出。

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

## 这个节点是做什么的

**Video Volume** 改变片段音轨的响度，并可在开头渐强（**fade\_in\_s**）、在结尾渐弱（**fade\_out\_s**）。
画面保持不变。这是服务端的真实重新编码（PyAV / ffmpeg），因此在 **▶ 运行**时执行，并把结果保存为项目快照。
输入输出均为 `COMFYTV_VIDEO`。

## 适用场景

* 在混音前，把过轻或过响的片段拉到可用电平。
* 在开头加轻柔淡入、结尾加淡出，让剪切点不「爆音」。
* 在用 Mux Audio 叠加音乐前，压低片段自身音量（volume 小于 1.0）。

## 参数说明

### volume（音量）

施加到音频上的增益倍数。范围 **0.0–8.0**，步进 0.05，默认 **1.0**。1.0 保持电平不变；0.0 静音；
2.0 大约响一倍。过大的值可能削波——请谨慎推高。

### fade\_in\_s（淡入时长）

开头淡入斜坡的长度，单位秒。范围 **0–60**，步进 0.1，默认 **0.0**（不淡入）。音频在这段时间内从静音升到目标电平。

### fade\_out\_s（淡出时长）

结尾淡出斜坡的长度，单位秒。范围 **0–60**，步进 0.1，默认 **0.0**（不淡出）。音频在片段结束前的这段时间内降到静音。

## 输出说明

| 输出        | 类型              | 含义                      |
| --------- | --------------- | ----------------------- |
| **video** | `COMFYTV_VIDEO` | 画面不变、音频经调整/淡化的片段，保存为快照。 |

## 小贴士

* volume = 0.0 会完全静音（想在保留淡化设置的同时静音时很有用）。
* 淡化作用于片段自身的边缘；若想与某个切点对齐，请先分割/裁剪，再淡化。

## Bridge 说明

`COMFYTV_VIDEO` 是项目快照引用，不是 ComfyUI 原生张量。要在 ComfyTV 与原生 ComfyUI 节点之间互通，
请插入 **Bridge**（`ComfyTV/Bridge`）。详见
[https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md。](https://github.com/jtydhr88/ComfyTV/blob/main/docs/bridges.md。)

## 相关节点

* **Mux Audio**——替换或混入另一条音轨。
* **Video Speed**——为片段变速（音频带音调补偿）。