Falcon Player（FPP）播放 .fseq 序列文件。Pixel LED Animator 3 可以直接导出 FSEQ，因此您能在编辑器中设计动画，再把结果交给 FPP 演出，而不必在编排软件里重建一遍。

关键不在导出按钮，而在于让 通道数量、像素顺序和布线布局 在 Pixel LED Animator、FSEQ 文件以及 FPP 所驱动的设备之间保持一致。这三项对了，序列第一次就能正常播放。

FSEQ 文件里有什么

FSEQ 文件是一段扁平的通道数值流，每帧一个数据块。文件头记录帧数、步进时间、通道数量以及可选的压缩方式。Pixel LED Animator 写入的是 FSEQ v2，支持可选的块索引和 Zstd 压缩。

它不保存矩阵的物理形状。只要通道顺序相同，一块 64 x 32 的蛇形面板和一块 64 x 32 的渐进式面板可以生成完全相同的 FSEQ 文件。布线由接收端应用：FPP 的 LED Panels 输出，或接收各宇宙数据的控制器。

先对齐通道数量

导出之前先算清通道数：

宽 x 高 x 3 = RGB 通道总数

矩阵像素通道
16 x 16256768
32 x 321,0243,072
64 x 322,0486,144
64 x 644,09612,288
128 x 648,19224,576

把 FPP 的输出设为同样的总数。如果 FPP 期望的通道数多于文件中的数量，多出来的通道会保持为零。如果期望的更少，序列末尾会被截断。

第 1 步：按最终矩阵尺寸设计

把 Pixel LED Animator 的画布设为矩阵分辨率，而不是视频分辨率。64 x 32 的矩阵就应该按 64 x 32 来设计。

选择一个 FPP 能稳定播放的帧率。30 FPS 是安全的默认值；40 或 50 FPS 在较小矩阵上没问题，但会增加文件大小和网络负载。时长保持在演出实际需要的范围内。

请记住，FSEQ 的每一帧都包含矩阵里的全部像素。高帧率下的长序列体积增长很快：

通道数 x 帧数 = 字节数

在 64 x 32、30 FPS 下，十秒在压缩前约为 1.8 MB。同样设置下，128 x 64 矩阵约为 7.4 MB。

第 2 步：导出 FSEQ

  1. 打开导出面板，选择 FSEQ 配置。
  2. 选择 FSEQ 压缩 方式：
    • None：与旧版 FPP 和工具的兼容性最广。
    • Zstd：目标 FPP 版本支持 Zstd 时，文件更小。
  3. 设置输出文件名和文件夹。
  4. 导出，并确认 .fseq 文件已生成、大小合理。

如果一段很长的动画只导出几 KB，说明导出过程并没有渲染出帧。请检查时长、画布和输出路径。

第 3 步：上传到 Falcon Player

  1. 打开 FPP 网页界面。
  2. 进入 Content Setup → File Manager。
  3. 打开 FSEQ 标签页。
  4. 上传 .fseq 文件。
  5. 确认文件出现，且大小符合预期。

File Manager 会把序列放进 FPP 的媒体目录。如果您手动拷贝文件，请使用 FPP 媒体目录下的 sequences 文件夹，而不是 U 盘的根目录。

第 4 步：配置输出

FPP 必须知道通道如何映射到物理输出。

  • 直接矩阵输出： 使用 Input/Output Setup → Channel Outputs → LED Panels。设置面板尺寸、面板布局，以及与实际搭建一致的蛇形或渐进式布线。
  • 外部控制器： 配置 E1.31 或 Art-Net 输出，并设置起始通道和宇宙数量。像素顺序和布线由控制器应用。
  • 混合系统： 让第一个像素位于通道 1，并记录每一路输出的起始通道。

像素顺序很重要。Pixel LED Animator 写入的是 RGB。如果灯带或控制器期望 GRB，请在控制器或 FPP 输出配置中设置。导出后再去改 FSEQ 并不是正确的做法。

第 5 步：先测试，再播放

播放序列之前，先用 FPP 的 Display Testing 填满矩阵并跑一次追逐。这样可以在不涉及序列文件的情况下验证供电、数据和布线。

然后：

  1. 进入 Content Setup → Playlists。
  2. 创建播放列表并添加 FSEQ 条目。
  3. 保存播放列表。
  4. 从 FPP 状态页或播放列表编辑器启动它，并观察前 10 秒。

检查第一帧、颜色和方向。如果画面被旋转或镜像，请修正面板布局或布线模式，而不是重新导出。

故障排除

问题解决方法
FPP 没有列出文件确认它位于 FSEQ 区域、扩展名为 .fseq，且上传已经结束
序列在播放但没有灯亮检查输出配置、起始通道和通道总数
颜色顺序颠倒在控制器或 FPP 输出中设置 RGB/GRB 顺序
画面偏移一个像素检查起始通道和第一个像素的索引
一半矩阵是黑的通道数量太少，或宇宙数量有误
播放过快或过慢让序列 FPS 与 FPP 时序以及导出帧率一致
Zstd 文件无法播放把压缩方式设为 None 后重新导出
文件太大降低 FPS、缩短序列，或启用 Zstd

常见问题

FSEQ 是 xLights 使用的同一种格式吗？ 是的。FSEQ 就是 xLights 导出、Falcon Player 播放的序列格式。Pixel LED Animator 直接写入 FSEQ v2，所以 xLights 并非必需。

用 FPP 必须要 xLights 吗？ 不需要。您可以从 Pixel LED Animator 导出 FSEQ，上传并播放。如果您想进一步编辑序列或管理更大的演出，xLights 会很有用。

FSEQ 包含音频吗？ 不包含。FSEQ 文件里只有通道数据。音频由 FPP 或演出控制器单独处理。

FPP 能把序列发给 WLED 吗？ 可以。把 FPP 配置为向 WLED 输出 E1.31，并把 WLED 设为 E1.31 接收端。FSEQ 里仍然是完整的通道流。

可以用 Raspberry Pi 矩阵代替控制器吗？ 可以。FPP 的 LED Panels 输出可直接驱动 Raspberry Pi RGB 矩阵。把面板布局和布线设为与实际搭建一致。

探索 Pixel LED Animator 3 · 查看所有集成 · 阅读 WLED 流式传输指南 · 购买终身许可证