WLED 卡在实时模式?“接管控制”是怎么工作的
E1.31、Art-Net、DDP、Hyperion 或 LedFx 在发送数据时 WLED 不听 App 指挥?找出发送方,用 JSON API 覆盖它,或者让它停下。
**快速回答:**您网络上的某个东西正在向灯推送实时像素数据(E1.31、Art-Net、DDP、UDP 实时、TPM2.NET、Hyperion 或类似的),而实时数据总是优先。停止发送方,或者等超时结束(默认 2.5 秒)。要覆盖它,向 JSON API 发送 {"lor":1} 表示“直到数据停止”,或 {"lor":2} 表示“直到下次重启”。在 WLED Max 中,这就是横幅上的 接管控制 按钮,iOS 和 Android 都有。
您点了一个效果,什么都没发生。您拖动色轮,灯闪了一帧又变回去。感觉像坏了,但 WLED 只是在严格执行它收到的指令。
绘制像素的两种方式
正常情况下 WLED 运行自己的效果。在实时模式下,另一个程序每秒多次发送每个 LED 的精确颜色,WLED 只负责显示。屏幕同步(Hyperion、HyperHDR)、音乐可视化(LedFx)和灯光控台(QLC+ 或 xLights 的 E1.31 或 Art-Net)都是这样工作的。
只要帧持续到达,您在 App 或网页界面里做的任何更改都会被下一帧覆盖。
是谁在发送?
灯会告诉您。在浏览器中打开 http://<light-ip>/json/info,找三个字段:
"live": true表示此刻正有实时数据进来。"lm"是实时模式,例如“E1.31”、“Art-Net”、“DDP”或“UDP”。"lip"是发送方的 IP 地址。
最后那个通常就能定位问题。到路由器的客户端列表里查这个地址。常见的嫌疑对象:
- 仍在 PC 或 Raspberry Pi 上运行的 LedFx 或 HyperHDR
- 测试灯光秀后仍在输出的 xLights 或 Falcon Player
- 正在推送效果的 Home Assistant 应用(以前叫加载项)或脚本
- 手机或电视盒子上的屏幕或音乐同步 App
让它停下,或者覆盖它
停止或重新配置发送方才是真正的解决办法。覆盖只是在发送方继续运行的同时压制症状。
话虽如此,覆盖很快。WLED 有一个实时数据覆盖设置,lor:
| 值 | 含义 |
|---|---|
{"lor":0} | 关闭。实时数据正常显示。 |
{"lor":1} | 覆盖,直到实时数据停止。 |
{"lor":2} | 覆盖,直到灯重启。 |
任何 HTTP 工具都能发送:
curl -X POST -H "Content-Type: application/json" -d '{"lor":1}' http://192.168.1.57/json/state
要让灯完全不再监听,在网页界面打开 Config›Sync Interfaces。在 Realtime 区块取消勾选 Receive UDP realtime。这会阻止 UDP 实时、Hyperion 和 TPM2.NET 数据,但不包括 E1.31、Art-Net 或 DDP。对于 E1.31 和 Art-Net,在 Network DMX input 下把 DMX mode 设为 Disabled。DDP 没有关闭开关,所以 DDP 发送方必须在源头停止。同一区块还有实时 Timeout(默认 2500 ms),即 WLED 在最后一帧之后等待多久才恢复正常。

WLED Max 中的“接管控制”
当外部源在驱动灯时,“控制”标签页会在 iOS 和 Android 上显示一条横幅,写着 外部控制中,并带有来源及其地址,例如“E1.31 (192.168.1.20)”。您自己的灯光提醒和拍照取色预览永远不会触发它。点 接管控制 并选择一项:

- 接管直到数据停止。App 立即接管,发送方停止后覆盖会自动结束。适合“LedFx 还在另一个房间跑着,我只想先正常用一会儿灯”的情况。
- 接管直到重启。覆盖保持到灯重启。适合发送方总是卷土重来、而您今晚没心情去找它的时候。
灯的行为和您从网页界面或 API 设置同样的覆盖时完全一致。
如果接管后发送方还在推流,横幅会变成一条不那么醒目的 您已接管控制 提示,列出被暂停的发送方,并带一个 交还控制 按钮。点它,发送方的颜色会重新显示。发送方停止后,提示会自己消失。
Hyperion 和 Ambilight 装置
如果灯带装在运行 Hyperion 或 HyperHDR 的电视背后(Ambilight 风格的背光),或者用作 LedFx 可视化器,实时模式正是目的所在。电视盒子或电脑是发送方,WLED 只显示收到的内容。两个设置能让两边和平共处:
- Timeout。 更短的超时(比如 1000 ms)能让 WLED 在发送方停止后更快回到自己的效果。
- Use main segment only(在 Sync Interfaces 中)。实时数据只绘制主分段,其他分段继续运行 WLED 效果。只有灯带的一部分在电视后面时很实用。
在 WLED Max 中,超时位于“设备设置 > 同步接口”的 E1.31 / DMX / Art-Net 区块,名为“超时(×100 毫秒)”,所以 25 表示 2.5 秒。该字段在开启“启用 E1.31/Art-Net”后才显示。
它总是再出现
在我的效果和另一个图案之间闪来闪去。 两个源在打架,或者某个发送方推流太慢,帧间隔超过了超时。用 lip 找到它并停掉。
重启后又卡住了。 发送方从未停止。lor 2 只持续到重启,这是有意设计的。停止发送方,或关闭实时接收。
xLights 或 Falcon Player 灯光秀。 序列器用同样的方式驱动 WLED。WLED 与 xLights介绍了 DDP、E1.31,以及灯光秀结束后会发生什么。
live 是 false,它还是不听我的。 那就不是实时模式。检查您改的是不是选中的分段,是否有调色板覆盖了您的颜色(见 WLED 颜色和白光通道),以及是否有播放列表在切换预设(WLED 播放列表与随机播放)。
常见问题
怎样让 WLED 退出实时模式? 停止发送数据的程序,或向 /json/state 发送 {"lor":1}。在 WLED Max 中,点“接管控制”。
WLED 里的“lor”是什么意思? Live data override(实时数据覆盖)。0 是关闭,1 持续到实时数据结束,2 持续到重启。
WLED 在哪些端口监听实时数据? UDP 实时默认端口 21324,E1.31 用 5568,Art-Net 6454,DDP 4048。