用手机麦克风让 WLED 随音乐律动
WLED 开发板上没有麦克风?您的手机可以用麦克风采集声音,并通过 WLED 音频同步经 Wi-Fi 把音乐电平传给灯。含设置和故障排除。
本文作者 Jamie Conde 在 MeowScript 开发 WLED Max。 WLED Max 是一款独立 App,与官方 WLED 项目无关,也未获其认可。
**快速回答:**WLED 可以对在别处采集的声音做出反应。AudioReactive 用户模块有一个“Receive”模式,监听 UDP 组播 239.0.0.1、端口 11988 上的音频同步数据,即音量和频率电平,而不是声音本身。任何发送这种数据的东西都能驱动效果,可以是另一块带麦克风的 WLED 开发板,也可以是手机 App。您的灯需要包含 AudioReactive 的固件版本。ESP32 的正式版本自 WLED 0.15 起就包含它。ESP8266 要看情况:0.15 的 160 MHz 版本有,WLED 16 的常规 ESP8266 版本也有(只能接收,ESP8266 无法发送)。
本页大部分内容讲的是音频同步在 WLED 内部如何工作,因此适用于任何发送端。我们的 App 在接近结尾处出场。
WLED 灯“听”声音的三种方式
- 开发板上的麦克风。 INMP441 之类的 I2S 麦克风,或 ESP32 上的模拟麦克风,引脚在 Config > Usermods > AudioReactive 中设置。这是经典做法。
- 来自另一盏 WLED 灯的音频同步。 一块带麦克风的开发板设为“Send”,其余设为“Receive”,它们就都对同一段声音做出反应。
- 来自手机的音频同步。 手机用麦克风采集声音,并发送与 WLED 发送端相同的数据包。灯既不知道也不在乎那是一部手机。
第 3 种方式很重要,因为大多数成品控制器和 DIY 灯带根本没有麦克风。
没有麦克风也能随音乐律动
没有麦克风的灯也可以随音乐律动。它需要一个包含 AudioReactive 用户模块的固件版本,设为 Receive,再加上同一网络上的一个发送端:另一块带麦克风的 WLED 开发板,或者一部手机。接收端的开发板上没有任何东西自己去听声音,所以那边不需要额外硬件。
开始之前
固件。 您需要包含 AudioReactive 用户模块的固件版本。ESP32 的正式版本自 0.15 起包含它。在 0.14 上它是单独的“audioreactive”下载包。在 ESP8266 上,WLED 0.15 只在“_160”版本中包含它,WLED 16 的常规 ESP8266 版本也包含,但 1 MB 的 ESP01 版本除外。ESP8266 只能接收,而这里恰好只需要接收。不确定?在网页界面中打开 Config > Usermods,看有没有 AudioReactive 部分。
网络。 手机和灯在同一个 Wi-Fi 网络。组播通常不会跨越 VLAN 或访客网络,所以一盏在 IoT VLAN 上的灯和一部在主局域网上的手机,没有组播路由的话往往无法通信。
效果。 必须是音频律动类效果。从 0.14 起,效果带有元数据,标明是音量律动还是频率律动,而 Rainbow 或 Solid 这类普通效果完全不理会声音。这是人们断定“它不工作”的头号原因。
把灯切换为 Receive
在 WLED 网页界面中:
- 打开 Config›Usermods。
- 找到 AudioReactive,勾选 Enabled。
- 在同步设置中,把模式设为 Receive。默认端口是 11988。除非您在发送端改过,否则保持不变。
- 保存。灯会重启,需要 10 到 15 秒。
- 在主页面上,从音频律动组中选一个效果(较新的网页界面版本用音符标记它们)。GEQ、Gravcenter、Waterfall 和 Freqwave 都是不错的测试选择。

有第二块带麦克风的 WLED 开发板?把它设为 Send 就完成了。如果您只有一部手机,就需要一个能发送 WLED 音频同步数据包的 App。
挑选会律动的效果
WLED 的音频效果监听两种东西之一。音量律动类使用整体响度,适合音乐不断变化的派对:Gravcenter、Gravimeter、Juggles、Puddles。频率律动类使用从低音到高音的 16 个频段,在节拍和旋律清晰时效果最好:GEQ、Freqwave、Freqmap、Waterfall、Rocktaves。
在 2D 矩阵上,GEQ 和 Waterfall 是显而易见的选择。在单条灯带上,先从 Gravcenter 或 Freqwave 开始。大多数效果仍然受速度和强度影响,所以一次只动一个滑块。

把手机当作麦克风
在 WLED Max 中,这就是音乐律动,“控制”标签页上的一个卡片。
- 在“控制”标签页打开这盏灯,点颜色选择器下方的 音乐律动 卡片。
- 允许访问麦克风。音频在手机上分析。发给灯的只有音乐电平(音量和频率电平),绝不会是声音本身或录音。
- 在 音频来源 下选择手机。如果您的某盏灯有自己能用的麦克风,也可以选那盏灯,让它广播给其他灯。(选中的灯都没有报告麦克风时,只显示手机这一个选项。)
- 选择 目标设备。免费版一盏灯,高级版可选您拥有的全部灯。
- 如果某盏灯还没有打开该用户模块,App 会询问 “在设备上启用音乐律动?”。选是。它会以 Receive 模式打开 AudioReactive,灯随后重启(10 到 15 秒)。
- 在同一屏幕的 音频律动效果 下选一个效果。
- 观察 频谱。柱条在动,说明音乐电平正在发送。调节 灵敏度,让音乐最响的部分刚好填满灯而不是一直顶在最大值,或者打开 自动增益控制 让它自行适应。



锁屏后 App 仍会继续发送电平,所以手机可以放在音箱旁边。在效果浏览器中,音量 和 频率 筛选器只显示您固件上会随声音律动的效果。
顺便说一句,音乐不一定要从手机播放。麦克风听到的是房间里的一切:电视、音箱、现场乐队。
灯没有反应
在灯上选 GEQ 或 Gravcenter,播放节拍强烈的音乐,观察 App 中的“频谱”。如果柱条在动而灯不动,问题在灯这一侧。
App 里柱条在动,灯毫无反应。 灯上的效果是音频律动类吗?然后检查 Config > Usermods 中 AudioReactive 已启用并设为 Receive。如果根本没有用户模块部分,说明您的固件版本不包含它(在运行 WLED 0.15 或更早版本的 ESP8266 上很常见)。
昨天还好,今天不行。 通常是手机连到了别的网络:5 GHz 访客网络、VPN、移动数据。组播只在一个网络内传播。关掉 VPN,检查 Wi-Fi 名称。
灯比音乐慢。 通过 Wi-Fi 有一点延迟是正常的。超过零点几秒说明 Wi-Fi 繁忙或灯那里信号弱。把手机挪近路由器比挪近灯更有帮助。
什么都顶到最大,连安静的歌也是。 灵敏度太高,或者手机紧贴着音箱。降低“灵敏度”,或使用“自动增益控制”。
只有部分灯有反应。 每盏灯都需要 AudioReactive 处于 Receive 模式。在另一个子网或 VLAN 上的灯,没有额外的路由器设置就收不到组播。
两个发送端打架。 一块带麦克风且同时设为 Send 的 WLED 开发板会与手机冲突。使用手机期间,把它设为 Receive,或关闭它的同步。
在为此比较 App?WLED App 对比介绍了哪些 App 能用手机麦克风做音频同步。其他灯设置请见用手机设置 WLED。