ComfyUI-AudioReactor 插件完全新手教程

1. 插件简介

ComfyUI-AudioReactor 是一个专门处理音频数据的神奇小工具，它能让你的ComfyUI变成一个"音频魔法师"！

插件地址： https://github.com/tocubed/ComfyUI-AudioReactor

这个插件到底能干什么？ - 读取你电脑里的音频文件（就像播放器读取音乐一样） - 把音频变成可以被ComfyUI理解的"数字信号" - 让你的图片或视频跟着音乐的节拍变化 - 制作音频可视化效果（就像那些炫酷的音乐播放器界面）

想象一下：你有一首很棒的音乐，想让它变成一个动态的视觉效果，或者让你的AI生成的图片跟着音乐的节拍跳舞，这个插件就是你的最佳选择！

2. 如何安装

方法一：ComfyUI Manager安装（推荐新手）

1. 打开ComfyUI界面
2. 点击右下角的"Manager"按钮
3. 在搜索框里输入"AudioReactor"
4. 找到这个插件后点击"Install"
5. 重启ComfyUI

方法二：手动安装

1. 找到你的ComfyUI安装文件夹
2. 进入custom_nodes文件夹
3. 打开终端（就像Windows的命令提示符）
4. 输入命令：git clone https://github.com/tocubed/ComfyUI-AudioReactor.git
5. 重启ComfyUI

3. 节点详细解析

3.1 Shadertoy节点 - 视觉效果制造机

这个节点就像一个"特效工厂"，专门制造各种炫酷的视觉效果。它使用Shadertoy技术（一种专门做酷炫视觉效果的工具）来创造动态画面。

3.1.1 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | 宽度 | width | 数字 | 512 | 决定画面有多宽，就像调整电视屏幕的宽度 | 输出图像的水平像素分辨率 | 想要手机竖屏效果就设小点，想要电脑宽屏就设大点 | | 高度 | height | 数字 | 512 | 决定画面有多高，就像调整电视屏幕的高度 | 输出图像的垂直像素分辨率 | 配合宽度使用，比如16:9比例可以用1920x1080 | | 着色器代码 | shader_code | 文本 | 默认代码 | 这是"魔法咒语"，告诉电脑要画什么样的效果 | GLSL着色器程序代码 | 可以从网上找现成的着色器代码复制进去 | | 时间 | time | 小数 | 0.0 | 就像动画的"播放进度条"，控制动画播放到哪一帧 | 着色器中的时间uniform变量 | 连接到时间控制器，让动画动起来 |

3.2 Load Audio (from Path)节点 - 音频文件读取器

这个节点就像一个"音乐播放器的读取头"，专门负责从你的电脑里读取音频文件，然后把它变成ComfyUI能理解的数据。

3.2.1 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | 文件路径 | file_path | 文本路径 | 无 | 告诉电脑你的音频文件放在哪里，就像给快递员地址 | 指向音频文件的完整路径 | 比如：C:\Music\我的歌.mp3 | | 开始时间 | start_time | 小数 | 0.0 | 从音频的第几秒开始播放，就像跳到歌曲的某个时间点 | 音频播放的起始时间点（秒） | 想跳过前奏就设成30.0（30秒后开始） | | 持续时间 | duration | 小数 | 无限制 | 要播放多长时间的音频，就像定时器 | 音频播放的持续时长（秒） | 只想要前60秒就设成60.0 | | 采样率 | sample_rate | 数字 | 44100 | 音频的"清晰度"，数字越大音质越好但文件越大 | 音频的采样频率（Hz） | 一般44100就够用，专业制作可以用48000 |

3.3 Audio Frame Transform (Shadertoy)节点 - 音频到视觉的翻译官

这个节点是个"翻译官"，专门把音频数据翻译成视觉效果能理解的语言，然后传递给Shadertoy节点制造炫酷效果。

3.3.1 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | 音频输入 | audio_input | 音频数据 | 来自Load Audio节点 | 就像给翻译官一段要翻译的话 | 输入的音频信号数据 | 连接Load Audio节点的输出 | | 频率范围 | frequency_range | 数字对 | [20, 20000] | 要分析哪个音调范围，就像调收音机的频道 | 音频频谱分析的频率范围（Hz） | 低音：20-250，中音：250-4000，高音：4000-20000 | | 平滑度 | smoothing | 小数 | 0.1 | 让变化更平滑，就像给数据加了"润滑油" | 音频数据的时间平滑处理强度 | 值越大变化越平滑，越小反应越敏感 | | 增益 | gain | 小数 | 1.0 | 音频信号的"放大器"，让反应更强烈或更温和 | 音频信号的增益系数 | 音乐太小声设成2.0，太响设成0.5 | | 归一化 | normalize | 布尔值 | True | 让音频数据保持在合理范围内，就像给数据加了"限速器" | 是否对音频数据进行归一化处理 | 开启后避免数据过大导致效果失控 |

3.4 Audio Frame Transform (Beats)节点 - 节拍感应器

这个节点就像一个"节拍感应器"，专门识别音乐里的鼓点和节拍，然后把这些节拍信息传递给其他节点，让视觉效果跟着音乐"跳舞"。

3.4.1 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | 音频输入 | audio_input | 音频数据 | 来自Load Audio节点 | 给节拍感应器提供要分析的音乐 | 输入的音频信号数据 | 连接Load Audio节点的输出 | | 节拍敏感度 | beat_sensitivity | 小数 | 0.5 | 节拍感应器的"敏感程度"，就像调节感应器的灵敏度 | 节拍检测的敏感度阈值 | 电子音乐用0.7，古典音乐用0.3 | | 最小节拍间隔 | min_beat_interval | 小数 | 0.1 | 两个节拍之间的最短时间，避免识别出"假节拍" | 检测节拍的最小时间间隔（秒） | 快歌设0.05，慢歌设0.2 | | 平滑窗口 | smooth_window | 整数 | 5 | 用几个数据点来判断节拍，就像用几个"证据"来确认 | 节拍检测的平滑窗口大小 | 值越大判断越准确但反应越慢 | | 节拍强度 | beat_strength | 小数 | 1.0 | 节拍信号的"力度放大器" | 节拍信号的强度系数 | 想要更强烈的效果就调大，想要温和点就调小 | | 低频权重 | low_freq_weight | 小数 | 1.0 | 对低音（鼓声、贝斯）的重视程度 | 低频段在节拍检测中的权重 | 重金属音乐可以调到2.0，钢琴曲调到0.5 | | 高频权重 | high_freq_weight | 小数 | 0.5 | 对高音（镲片、小提琴）的重视程度 | 高频段在节拍检测中的权重 | 电子音乐调到1.0，古典音乐调到0.3 |

4. 使用技巧和建议

4.1 新手必看的连接顺序

1. Load Audio (from Path) → Audio Frame Transform (Beats) → Shadertoy
2. Load Audio (from Path) → Audio Frame Transform (Shadertoy) → Shadertoy

4.2 参数调节小贴士

音频文件选择： - 选择节拍明显的音乐效果更好（比如电子音乐、摇滚乐） - 避免选择过于复杂的交响乐作为第一次尝试

频率范围设置： - 想要跟着鼓点变化：设置20-250Hz - 想要跟着人声变化：设置250-4000Hz
- 想要跟着高音变化：设置4000-20000Hz

平滑度调节： - 新手建议从0.1开始 - 如果效果变化太剧烈，增加到0.3-0.5 - 如果效果反应太慢，减少到0.05

4.3 常见搭配组合

基础音乐可视化： Load Audio → Audio Frame Transform (Shadertoy) → Shadertoy

节拍同步效果： Load Audio → Audio Frame Transform (Beats) → Shadertoy

双重分析： Load Audio → 同时连接两个Audio Frame Transform → 分别连接不同的Shadertoy

5. 常见问题解答

Q1：为什么我的音频文件加载不了？

A： 检查以下几点： - 文件路径是否正确（没有中文字符最好） - 文件格式是否支持（推荐使用MP3、WAV格式） - 文件是否损坏（试试用其他播放器播放）

Q2：为什么视觉效果不跟着音乐变化？

A： 可能的原因： - 节点之间没有正确连接 - 音频文件太安静，试试调大gain参数 - 平滑度设置过高，试试调小smoothing参数

Q3：效果变化太剧烈怎么办？

A： 调节这些参数： - 增加smoothing值到0.3-0.5 - 减少gain值到0.5-0.8 - 开启normalize选项

Q4：节拍检测不准确怎么办？

A： 尝试这些方法： - 调整beat_sensitivity参数 - 修改min_beat_interval适应歌曲节拍 - 调整低频和高频权重

Q5：Shadertoy代码从哪里找？

A： 推荐网站： - Shadertoy.com官网 - GitHub上的shader合集 - 从简单的代码开始学习

6. 进阶玩法

6.1 多音轨分析

你可以同时加载多个音频文件，分别分析不同的音轨（比如分别分析主旋律和鼓点），然后制作更复杂的视觉效果。

6.2 实时音频输入

虽然这个插件主要处理音频文件，但你也可以录制实时音频然后立即分析，制作实时的音乐可视化效果。

6.3 与其他节点结合

试试把音频分析的结果传递给其他ComfyUI节点，比如： - 控制图片的颜色变化 - 控制动画的速度 - 控制特效的强度

7. 总结

ComfyUI-AudioReactor插件把音频处理变得像搭积木一样简单！记住最重要的几点： - 先加载音频文件 - 选择合适的分析方式（频谱分析还是节拍检测） - 调节参数让效果更符合你的需求 - 多试验不同的参数组合

不要害怕出错，每个参数都可以随时调整。从简单的效果开始，慢慢尝试更复杂的组合。相信很快你就能制作出令人惊艳的音乐可视化效果！

这个教程是为完全的新手写的，如果你在使用过程中遇到任何问题，记住：多试验，多调参数，多看效果！ComfyUI的魅力就在于无限的可能性。