脚本

AM机架支持脚本功能，允许用户自定义自动化任务、控制插件参数或创建复杂的交互功能。本节介绍脚本系统的基础知识和使用方法。

概述

脚本系统提供了强大的扩展能力，允许用户通过编程方式控制AM机架的各种功能。支持的脚本语言包括JavaScript和Lua，用户可以根据需求选择合适的语言。

脚本可以用来实现：

自动化常规任务
创建自定义MIDI映射
响应特定事件（如播放开始、停止等）
与其他应用程序或硬件设备通信
修改插件参数随时间变化

脚本类型

AM机架支持多种类型的脚本，每种类型有不同的用途和生命周期：

启动脚本: 在AM机架启动时执行，可用于初始化设置或加载预设配置。
事件响应脚本: 响应特定事件（如MIDI消息、播放状态改变等）而执行。
定时脚本: 按固定间隔执行，可用于实时参数修改或监控。
宏脚本: 封装一系列操作，可由用户手动触发执行。

示例

以下是一些常用的脚本示例：

简单的MIDI映射脚本

// 将MIDI CC #1映射到插件参数
onMidiCC(1, function(value) {
    setParameter("MyPlugin", "Gain", value / 127.0);
});

播放控制脚本

// 播放开始时执行的动作
onPlayStart(function() {
    log("Playback started");
    setParameter("Metronome", "Enable", true);
});

onPlayStop(function() {
    log("Playback stopped");
    setParameter("Metronome", "Enable", false);
});

调试脚本

调试脚本对于开发可靠的自动化功能至关重要。AM机架提供了一些调试工具：

控制台输出：使用log()函数输出调试信息到控制台
断点调试：在脚本中插入断点以暂停执行
错误报告：详细的错误信息帮助定位问题