WLED WLED Max 故障排除 实时

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 地址。
有东西在推流时的 /json/info
"live"true
"lm""E1.31"
"lip""192.168.1.20"

最后那个通常就能定位问题。到路由器的客户端列表里查这个地址。常见的嫌疑对象:

  • 仍在 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 网页界面
WLED Sync 设置中的 Realtime 区块:已勾选 Receive UDP realtime、Use main segment only、Respect LED Maps,然后是 Network DMX input,类型 E1.31、起始 universe、DMX mode Multi RGB、Timeout 2500 ms 和 Force max brightness
Sync Interfaces 中的 Realtime 区块。DMX mode 是关闭 E1.31 和 Art-Net 的地方,Timeout 的单位是毫秒。

WLED Max 中的“接管控制”

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

iOS
WLED Max 的“控制”标签页,顶部有一条橙色横幅:“外部控制中”,E1.31 (192.168.1.20),以及一个“接管控制”按钮
iOS 上 E1.31 发送方驱动灯时显示的横幅。
  • 接管直到数据停止。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。

本文作者

Jamie Conde,在 MeowScript 开发 WLED Max App。WLED 本身是独立的开源项目,我们不是它的一部分。 我们的 iOS 和 Android App WLED Max,一盏灯免费,功能不打折。一次性购买即可添加更多灯。