企业官网建设流程全解析

Falcon Player排程功能详解：自动化灯光表演的实现

【免费下载链接】fppFalcon Player项目地址: https://gitcode.com/gh_mirrors/fpp/fpp

Falcon Player（FPP）是一款强大的开源灯光控制软件，其核心排程功能能够帮助用户轻松实现灯光表演的自动化运行。通过直观的界面和灵活的配置选项，即使是新手用户也能快速上手，打造专业级的定时灯光秀。

排程功能核心价值：解放双手的自动化方案 ✨

排程功能是Falcon Player实现无人值守灯光表演的关键。无论是节日装饰、舞台演出还是商业展示，通过预先设定的时间规则，系统能够自动触发播放列表、执行命令或运行序列文件，让灯光效果精准呈现在预定时间。

图：Falcon Player排程系统可控制的灯光设备背景示意图

排程系统基础架构与文件路径

排程功能的核心配置文件存储在/home/fpp/media/setting/schedule.json，该JSON文件包含所有排程条目信息，包括播放列表名称、运行日期、时间设置等关键参数。通过Web界面修改的排程设置会自动同步到该文件[docs/Configuration_Files.md]。

主要相关文件路径：

• 排程配置界面：[www/scheduler.php]
• 排程预览功能：[www/schedulePreview.php]
• 排程API接口：[www/api/controllers/schedule.php]
• 排程统计信息：[www/api/controllers/stats.php]

快速上手：3步创建基础排程

1️⃣ 访问排程管理界面

登录FPP Web控制台后，点击顶部导航栏的"Schedule"菜单进入排程管理页面。系统会显示当前所有排程条目，初次使用时列表为空。

2️⃣ 添加排程条目

点击"Add Entry"按钮创建新排程，主要配置项包括：

• 类型选择：可选择播放列表(playlist)、序列文件(sequence)或系统命令(command)
• 时间设置：支持固定时间、日出/日落（需配置经纬度）及偏移量调整
• 日期范围：可设定开始/结束日期或选择节假日（如圣诞节、新年）
• 重复规则：按日、周或自定义日期掩码重复

3️⃣ 保存并启用

完成配置后点击"Save"保存排程，系统会自动重载配置使新排程生效。可在[www/schedulePreview.php]页面查看未来一段时间的排程执行计划。

高级排程技巧：打造复杂灯光表演

基于日出日落的智能触发 🌞🌙

FPP支持根据地理位置的日出日落时间自动调整播放计划。在[www/settings.php#settings-system]配置经纬度后，排程时间可选择"SunRise"或"SunSet"，并通过偏移量微调（如日落前30分钟）[www/help/warning-helpers/warning-48.md]。

节假日特殊安排

通过"Holiday Editor"功能创建自定义节假日（如独立日、感恩节），并在排程中直接选择这些特殊日期。系统会自动计算每年的具体日期，无需手动更新[www/scheduler.php]。

多条件组合排程

利用"Day Mask"功能实现复杂的日期规则，例如：

• 每周一、三、五运行的常规模式
• 每月1号和15号的特殊效果
• 工作日与周末的不同播放列表

命令型排程扩展功能

除了播放灯光序列，排程还可触发系统命令，实现：

• 设备电源控制
• 音量调节
• 网络唤醒其他设备
• 发送MQTT消息联动其他系统[docs/MQTT.md]

排程故障排除与常见问题

排程不执行的排查步骤

1. 检查FPP模式是否为"Player"（远程模式下排程不会执行）[www/help/warning-helpers/warning-29.md]
2. 确认系统时间是否准确（时间错误会导致排程偏差）[www/help/warning-helpers/warning-55.md]
3. 验证播放列表/序列文件是否存在（文件缺失会导致排程自动禁用）[www/help/warning-helpers/warning-23.md]
4. 查看排程状态指示器（在[www/index.php]首页可快速查看当前排程状态）

排程冲突处理

当多个排程条目时间重叠时，系统遵循以下规则：

• 高优先级条目优先执行（可在排程编辑页面调整优先级）
• 同一时间只能运行一个播放列表，但可并行执行命令型排程
• 正在运行的受保护播放列表不会被新排程中断[www/api/controllers/playlist.php]

排程数据管理与备份

排程配置可通过FPP的备份功能导出，包含在"Full/All"备份类型中。建议定期备份以防止配置丢失[www/backup.php]。备份文件中排程数据存储路径为config/schedule.json[www/api/controllers/files.php]。

通过排程功能，Falcon Player将灯光控制从手动操作提升到自动化管理，让用户能够专注于创意设计而非机械执行。无论是小型家庭装饰还是大型舞台演出，这一功能都能提供可靠、灵活的时间控制方案，实现真正意义上的"一次设置，自动运行"。

【免费下载链接】fppFalcon Player项目地址: https://gitcode.com/gh_mirrors/fpp/fpp