当前位置：首页 > 文章列表 > 科技周边 > 人工智能 > Mulerun连接MIDI方法详解

Mulerun连接MIDI方法详解

2026-04-14 10:34:30 0浏览收藏

MuleRun虽不内置MIDI驱动，但通过浏览器原生Web MIDI API与Web Serial API，可在Chrome/Edge中无缝接入各类MIDI硬件——从主流USB键盘（如Akai MPK Mini）到传统串口接口设备，实现音符触发、CC旋钮实时映射表单字段、力度参数捕获等深度交互；只需四步：授权浏览器MIDI权限、用Custom Script监听并存为变量、将物理控制器绑定至结构化输入字段、或手动解析串口MIDI字节流，即可让音乐创作、音频自动化与AI工作流真正联动起来。

Mulerun怎么连接MIDI Mulerun外部输入方法

如果您希望在MuleRun中接入外部MIDI设备以实现音乐控制、实时参数映射或音序触发，则需通过浏览器端Web MIDI API桥接硬件信号。MuleRun本身不内置MIDI驱动，但支持在兼容环境中调用系统级MIDI接口并将其事件流转化为可编程变量。以下是实现此连接的具体方法：

一、启用浏览器Web MIDI API权限并授权设备访问

该步骤是所有MIDI交互的基础，确保Chrome或Edge浏览器已开启Web MIDI功能，并允许MuleRun页面访问本地MIDI端口。未完成此授权将导致设备列表为空或onstatechange事件无响应。

1、使用Chrome 115+或Edge 115+浏览器访问https://app.mulerun.ai。

2、点击地址栏左侧的锁形图标，选择“网站设置”。

3、在“权限”列表中找到“MIDI设备”，将其设置为“允许”。

4、刷新页面后，在MuleRun任意支持指令输入的区域键入：midi:connect --auto，系统将自动扫描并列出已连接的MIDI输入设备（如Akai MPK Mini、Novation Launchkey等）。

二、配置MIDI消息监听器并绑定至MuleRun变量

此方式通过JavaScript运行时注入监听逻辑，将MIDI通道消息（Note On/Off、CC、Pitch Bend等）实时映射为MuleRun流程中可引用的变量，供后续Agent调用或条件判断使用。

1、在MuleRun工作流编辑器中插入一个“Custom Script”节点。

2、在脚本内容区粘贴以下代码段：

if ('requestMIDIAccess' in navigator) { navigator.requestMIDIAccess().then(access => { access.inputs.forEach((input, id) => { input.onmidimessage = e => { const cmd = e.data[0] >> 4; const ch = e.data[0] & 0xf; const note = e.data[1]; const vel = e.data[2]; if (cmd === 9 && vel > 0) { mule.setVar('midi_note', note); mule.setVar('midi_velocity', vel); } }); }); }); }

3、保存节点后启用该流程，确保MIDI键盘处于通电且USB连接状态。

4、在后续节点中可通过表达式${midi_note}或${midi_velocity}直接读取最新触发音符与力度值。