SuperAPI AI 工具集

m4l-overview

通用与其它

查看项目

更新于 10-16 03:41

技能介绍

用途:这是 Max for Live(M4L)的总索引与技能路由条目。M4L 是嵌入 Ableton Live 的 Cycling '74 Max,设备保存为 .amxd(包裹 .maxpat JSON patcher 的二进制容器)。该技能用于在开始任何 M4L 工作前,先判断被要求的任务类型,再加载匹配的子技能,而不是从记忆中回忆格式细节。

主要能力:按任务路由到对应子技能,包括 .maxpat JSON 生成与编辑(m4l-maxpat-format)、.maxpat 与 .amxd 互转及设备包装和“无法打开”排错(m4l-amxd-conversion)、GUI 溢出与演示布局(m4l-presentation-layout)、Ableton 通信与 Live 参数暴露(m4l-live-api)、JS/Gen/调试与 Python 生成工具(m4l-javascript、m4l-gen、m4l-debugging、m4l-py2max-tooling)。同时整理三类设备类型所需的 FOURCC 标签与 I/O 对象:音频效果 aaaa 用 plugin~→DSP→plugout~;乐器 iiii 用 midiin→voice engine(poly~)→plugout~;MIDI 效果 mmmm 用 midiin→transform→midiout。

使用方式:建议从模板出发(如 templates/minimal-{audio-effect,instrument,midi-effect}.maxpat),修改而非从零构建;UI 用整数坐标放在 169 像素高度以内;用设备类型正确的 I/O 对象连接 DSP/MIDI;参数需 parameter_enable: 1 加 saved_attribute_attributes.valueof 块;用 py2max 的 write_amxd 或独立打包脚本生成 .amxd;拖入 Live 测试加载(双击不会加载),右键设备标题打开 Max Window 看错误。

限制与注意:GUI 严格限制 169 像素高度,presentation_rect 的 y+h 超过即被裁剪;.amxd 不是简单改名的 .maxpat,含 36 字节混合端序头部与 IFF 式尾部;.amxd 内的 .maxpat 必须含 project 块否则拒绝加载;触及 Live API 的初始化用 live.thisdevice 而非 loadbang;只有 live.* 对象能成为可自动化或 MIDI 映射的 Live 参数;参数可见性需为 Automated and Stored;复杂任务通常需要组合 2-3 个子技能。Live 12 还有 MIDI Tools 第四类设备(FOURCC 为 nagg 与 natt),属特殊情况。