用途:为 .maxpat(Cycling '74 Max patcher 格式)提供权威 JSON 模式,供编写、编辑或校验 .maxpat / .maxhelp JSON 时参考。
格式要求:.maxpat 是单一 JSON 对象,仅有顶层键 "patcher";使用 UTF-8、无 BOM、无注释、无尾随逗号、不允许 NaN/Infinity,Max 解析器严格。坐标字段为浮点数,presentation_rect 必须取整。
主要结构:顶层 patcher 需输出 fileversion、appversion(对象而非字符串,Max 8+ 需 modernui:1)、classnamespace(普通为 "box",gen~ 为 "dsp.gen",RNBO 为 "rnbo",poly~ 声部为 "dsp.basic")、rect、boxes、lines 等。boxes 中每个元素为 {"box": {...}},必填 id、maxclass、numinlets、numoutlets、patching_rect;numinlets/numoutlets 必须与底层类一致,outlettype 长度须等于 numoutlets。lines 中每条为 {"patchline": {...}},source/destination 为 [id, 索引],索引越界会静默丢线。
可选与专项:parameters 为自动生成,建议生成时省略;parameterbanks 描述 Push 硬件分库;dependency_cache 可为 []。打包为 .amxd 时必须包含 project 块,否则报错拒绝加载;日期使用 1904 纪元(mac_epoch = unix_epoch + 2082844800),amxdtype 为 FOURCC 大端值,如音频效果 1633771873、乐器 1768515945、MIDI 效果 1835887981。子修补器为 "p name"/"patcher name" 的 newobj 加嵌套 "patcher" 对象。
使用方式:建议复制最小模板(音频效果、乐器、MIDI 效果)后修改;推荐用 py2max 工具生成复杂设备,它能通过含 1157 个对象的 MaxRef 数据库校验音视频进出数。生成后应在 Max 中打开并保存一次以归一化依赖缓存与顺序。
限制与陷阱:重复 id 会静默合并或丢失;控制字符、BOM、注释、尾随逗号会被拒绝;基础设施对象不应标记 presentation:1;live.* 控件忘记 varname 将无法被 thispatcher、live.banks 或 pattr 寻址;flonum 与 float、number~ 与 number 需区分。资料未提供具体收费、价格或平台信息。