WLED 运行在 ESP32 和 ESP8266 板子上，用来驱动可寻址 LED 灯带和矩阵。Pixel LED Animator 3 可以通过网络实时把像素帧发送给 WLED，动画因此能直接现场播放，而不必先拷贝到存储卡。
这会改变工作流程。您可以一边看着真实矩阵一边调效果，立刻验证布线，并且只要连接不断，就能一直跑一段序列。
连接是如何工作的
Pixel LED Animator 发送包含像素数据的 UDP 数据包，WLED 收到后切换到实时模式，并把数值写到 LED 上。编辑器负责渲染，WLED 负责输出。
同一种帧可以由多种协议承载：
| 协议 | 默认端口 | 寻址方式 | 最适合 |
|---|---|---|---|
| DDP | 4048 | 按像素偏移，不划分宇宙 | WLED，设置最简单 |
| E1.31 / sACN | 5568 | 每个宇宙 510 个通道 | 混合控制器系统、FPP |
| Art-Net | 6454 | 每个宇宙 512 个通道 | 灯光控制台、MADRIX |
| TPM2.net | 65506 | 顺序像素数据 | Jinx、FPP、支持该协议的 WLED 版本 |
| KiNet | 6038 | 顺序像素数据 | Color Kinetics 和 MADRIX 硬件 |
用于 WLED 时，请从 DDP 开始。它省掉了宇宙换算，用最少的数据包发送一帧。当 WLED 属于本身已经在用 sACN 的大型系统时，再用 E1.31。
KiNet 不是 WLED 协议。它面向 Color Kinetics 驱动器和 MADRIX 类方案，请不要为 WLED 板子选择它。
第 1 步：配置 WLED
- 打开 WLED 网页界面。
- 进入 Config → LED Preferences，把 LED 总数设为
宽 x 高。 - 设置与灯带或面板一致的颜色顺序：RGB、GRB、BRG 等。
- 打开 2D Matrix 配置，设置面板宽度、高度和布线布局。视 WLED 版本不同，这一项位于 LED Preferences 或独立的 2D 设置页面。
- 进入 Config → Sync Interfaces，启用 DDP。只有在计划使用时，才启用 E1.31 或 Art-Net。
- 通过 DHCP 保留地址给板子分配固定 IP。
- 在发送外部数据之前，先用 WLED 内置效果测试矩阵。
如果内置效果显示就不对，外部推流的结果也不会对。请先修正矩阵尺寸和布线。
第 2 步：在 Pixel LED Animator 中匹配布线
打开流式传输窗口，选择 WLED 协议按钮。
- WLED IP： 板子的地址，例如接入点模式下的
192.168.4.1，或局域网中的 DHCP 地址。 - 协议：
DDP (Recommended)。 - 端口： 保留 Default，除非您的 WLED 版本使用自定义端口。
- 布线模式： 选择与物理矩阵匹配的模式：顺序、蛇形、垂直或垂直蛇形。
- 亮度： 测试时保留一个总亮度上限，演出时再提高。
编辑器中的布线模式和 WLED 中的 2D 矩阵设置必须一致。如果一边设为蛇形，另一边设为渐进式，画面就会在每一行撕裂或镜像。
第 3 步：用测试模式验证
打开流式传输窗口中的 测试模式 组，发送一个图案：
- 纯色 检查供电和基本颜色。
- 追逐 检查像素顺序和方向。
- 交替 检查奇偶布线。
- RGB 循环 检查颜色顺序。
- 彩条 检查行与列的映射。
- 渐变 暴露色带和伽马问题。
在推流动画之前先发一个测试图案。布线故障在追逐图案里，比在流动的等离子效果里容易看出得多。
如果画面镜像、反向或旋转了，请修正布线模式或 WLED 的 2D 方向，不要靠修改动画来补偿。
第 4 步：开始推流
点击 Start Streaming，观察 FPS 计量器和 DMX 活动显示。然后检查：
- 第一帧与编辑器预览一致。
- 运动流畅，没有可见卡顿。
- 颜色与调色板一致。
- 亮度变化时矩阵不闪烁。
WLED 有实时数据超时机制。如果推流中断，WLED 会在短暂延迟后回到自己的常规效果。这是预期行为，不是故障。
第 5 步：在实时与脱机之间选择
推流非常适合调试和现场演出，但不适合必须在没有电脑时也能启动的长期安装。
| 使用场景 | 最佳输出 |
|---|---|
| 在真实矩阵上调整效果 | 实时 DDP 流 |
| 有电脑参与的现场演出 | 实时 DDP 或 E1.31 |
| 脱机安装 | 导出的视频、GIF 或控制器文件 |
| 由 FPP 管理的演出 | FSEQ 序列 |
| SD 卡控制器 | XDAT 或视频 |
脱机播放时，请导出成片并使用控制器支持的格式。导出格式指南 介绍了其中的取舍。
网络与性能上限
原始像素带宽很容易计算：
宽 x 高 x 3 x FPS = 每秒字节数
| 矩阵 | 单帧大小 | 30 FPS 时 |
|---|---|---|
32 x 32 | 3,072 字节 | ~0.74 Mbps |
64 x 32 | 6,144 字节 | ~1.47 Mbps |
64 x 64 | 12,288 字节 | ~2.95 Mbps |
128 x 64 | 24,576 字节 | ~5.9 Mbps |
这些数字还没算上数据包开销。Wi-Fi 能承载这些流量，但延迟和抖动比原始吞吐更重要。对于大型矩阵：
- 如果板子支持，请在 ESP32 上使用以太网。
- 让接入点靠近，并使用干净的频道。
- 记住大多数 ESP32 板子只支持 2.4 GHz，5 GHz 网络不会出现在列表中。
- 关闭路由器的客户端隔离，让电脑能访问板子。
- 在 WLED 中限制亮度，以免超出电源容量。
故障排除
| 问题 | 解决方法 |
|---|---|
| WLED 没有反应 | 检查 IP 地址，在 WLED 中启用 DDP，确认两台设备在同一网络 |
| 只有部分矩阵更新 | 布线模式、矩阵尺寸或宇宙数量有误 |
| 画面镜像或旋转 | 让编辑器的布线模式与 WLED 的 2D 方向一致 |
| 颜色不对 | 在 WLED 中设置正确的颜色顺序 |
| 闪烁或随机像素 | 电源注入、电平转换、数据线松动或 Wi-Fi 重传 |
| 几秒后推流中断 | WLED 实时超时；保持推流运行并检查网络 |
| 帧率偏低 | 降低画布尺寸或 FPS，使用以太网，减少其他 Wi-Fi 流量 |
| 在发现中找不到板子 | 防火墙、子网或 AP 隔离；手动输入 IP |
常见问题
WLED 能直接播放视频文件吗？ 通常意义上不能。WLED 显示的是实时像素数据或它自带的效果。视频播放需要特定的 usermod 和硬件，与从编辑器推流帧不是一回事。
该用 DDP 还是 E1.31？ 纯 WLED 方案用 DDP。当 WLED 与 FPP、灯光控制台或其他 sACN 设备共享网络时，用 E1.31。
能通过互联网推流吗？ 借助隧道可以做到，但不推荐。像素推流对延迟敏感，而且会把控制器暴露到网络上。请把它留在局域网内。
停止推流后动画会留在 WLED 上吗？ 不会。推流传输的是实时数据。需要脱机播放时，请为控制器导出文件或使用 FPP。
WLED 能带多少像素？ 这取决于 ESP32 板子、帧率、网络和供电。请在真实矩阵上按目标帧率实测，而不要依赖宣传数字。
探索 Pixel LED Animator 3 · 查看所有集成 · 阅读 Falcon Player FSEQ 指南 · 购买终身许可证