SuperAPI AI 工具集

flstudio-scripting

编程与开发

查看项目

更新于 10-15 20:35

技能介绍

用途:为 FL Studio 的 Python 脚本开发提供参考,涵盖 MIDI 控制器脚本、钢琴卷帘音符与标记操作、Edison 音频编辑,以及不依赖 FL Studio 运行的 .flp 工程文件解析(PyFLP)。

要求与安装:需要 FL Studio 20.8.4+ 与 Python 3.6+。脚本放入 Shared\Python\User Scripts 文件夹。可用 import general; general.getVersion() 查看 API 版本。

三种脚本环境:一、MIDI 控制器脚本,在 FL Studio 打开期间持续运行,用于通过硬件控制器控制软件并回传反馈,可用模块有 transport、mixer、channels、arrangement、patterns、playlist、device、ui、general、plugins、screen、launchMapPages、utils、callbacks;入口回调包括 OnInit、OnDeInit、OnMidiMsg、OnControlChange、OnNoteOn、OnRefresh。二、钢琴卷帘脚本,通过 Scripts 菜单一次性执行,使用 flpianoroll、enveditor,可经 flpianoroll.score.notes 访问音符。三、Edison 音频脚本,在 Edison 上下文内一次性执行,使用 enveditor。

常用模块与要点:transport 控制播放、录音、位置、速度与循环;mixer 控制音量、声像、静音、独奏、EQ、路由与效果;channels 控制通道机架与步进音序器;arrangement/patterns 管理标记、时间与样式;playlist 管理播放列表轨道;device 负责 MIDI 输入输出与 sysex;ui/general 控制窗口、导航、撤销与吸附;plugins 管理插件参数与预设;screen/launchMapPages 支持 AKAI Fire 屏幕与 Launchpad 页面;callbacks 定义回调与 FlMidiMsg 事件流。

使用限制与建议:在 device 相关调用前先判断 device.isAssigned(),并实现双向同步;回调中避免密集循环(建议 10ms 内);在 OnControlChange 中将事件标记为 handled 以防重复处理;为性能考虑在顶层缓存模块引用。排错时检查设备分配、MIDI 端口设置与回调定义位置,并确认钢琴卷帘中已打开样式。GUI 自动化能力有限,ui 模块仅提供部分访问。完整示例与各模块 API 签名见对应参考文件;资料未提供收费、价格及更多平台信息。