用途:介绍在 Max for Live 中编写 JavaScript 的完整要点,包括对象选择、LiveAPI 使用、任务调度、线程规则和自定义 UI 绘制。
对象选择:js 为 SpiderMonkey 旧引擎(ES5,无 UI);v8 为 V8 引擎(Max 8.2+,ES6+),是新代码默认;jsui 和 v8ui 分别对应旧/新引擎并支持 sketch 与 mgraphics 绘图。四者均可在 M4L 内使用 LiveAPI。注意无浏览器 API,无 setTimeout/setInterval,改用 Task;js 中 console.log 不可用,需 post()。
必备样板:顶层设置 inlets、outlets、autowatch = 1(开发时更新 .js 后自动重编译)。标准处理器包括 bang、msg_int、msg_float、list、anything、loadbang;输出用 outlet,日志用 post/error/cpost。
LiveAPI:仅在 .amxd 内定义。属性有 id、path、type、property、proptype、children、info、valid 等;方法有 goto、get、getstring、set、call、getcount、getchildren、getchildids。观察模式通过设置 property 启动,回调参数格式为 [属性名, ...值]。关键规则:绝不在全局代码或 loadbang 中创建 LiveAPI,须由 live.thisdevice 的 bang 触发;LiveAPI 不能在高优先级线程使用,必要时加 deferlow。
Task:替代 setTimeout,支持 schedule、repeat、execute、cancel,interval 默认 500ms,运行在低优先级调度器,非采样精确。
线程模型:高优先级用于节拍/MIDI 时钟,低优先级用于 UI 和 LiveAPI;JS 无法做音频速率处理,采样精确触发需用 gen~。
UI 绘制:v8ui/jsui 可用 mgraphics(paint 回调、相对/像素坐标、move_to、arc 等图元、redraw 重绘)或旧 sketch。事件处理器有 onclick、ondblclick、ondrag、onidle、onresize。注意 patching 与 Presentation 尺寸不一致会导致命中偏移。可映射参数宜用 live.dial,多控件用 live.* 对象,自定义可视化才用 v8ui。
其它:Buffer 构造可访问 buffer~ 数据;v8 中用 File/Folder 处理 JSON 与文件 I/O。常见错误包括全局创建 LiveAPI、忘开 autowatch、js 里用 ES6、误把观察参数当值、通知中直接 set 等。JS 运行于低优先级,性能上应将 DSP 交给 gen~/MSP。