在剧场、演出和多媒体控制场景中，QLab经常会通过MIDI信号跟调音台、灯光控制台、键盘或各种外部控制器配合工作。表面上看，MIDI配置好像只是选择一个端口那么简单，但实际里面牵扯到发送方、接收方、MIDI通道、消息的类型以及macOS系统的权限许可这些环节。很多情况下，问题并非出在QLab本身，而是端口没有正确打开、消息的类型对不上，或者macOS的权限设置挡住了通信。

　　一、QLab怎么设置MIDI触发

　　准备做MIDI触发之前，先要理清哪一端负责发送消息、哪一端负责接收。在QLab这一侧，它既可以接收外来的MIDI消息去执行对应的命令，也可以主动对外发送MIDI来控制别的设备。

　　1、先把MIDI输入功能打开

　　进入QLab的偏好设置，依次点开【QLab】→【Settings】→【MIDI】这一项，在MIDI输入或MIDI路由相关的设置页面中，把需要用到的MIDI设备勾选起来。像外接的键盘、数字调音台或者虚拟MIDI端口，如果没有在这里打上勾，那QLab就不会去监听它们发过来的消息，后面再怎么配也收不到。

　　2、为Cue添加MIDI触发条件

　　选中那个需要由MIDI消息去控制的Cue，接着打开Inspector面板，找到Triggers这个区域；在里面新增一条触发条件，并把触发方式选成MIDI Message，然后指定具体的MIDI类型，比如Note On、Control Change或者Program Change当中的一种，同时把对应的通道号和编号都填上，这样条件才算完整。

　　3、确保发送端发出的消息与QLab这边设置的一致

　　举个例子，假如灯光控制台送过来的是Control Change 12，那么QLab这一头也得去监听完全相同的消息类型和编号；如果只改了MIDI通道，可是编号仍然对不上，这个Cue就没办法被触发。通常键盘一类的设备主要发送Note On，而控制台则更多地使用Control Change或Program Change，搞清楚对方发出的到底是什么很重要。

　　4、实际测试一下触发能否跑通

　　把上面的配置做完以后，直接从外部的设备发一次MIDI消息过来，QLab收到正确的消息时，对应的Cue应该会立即执行，或者进入等待状态。正式演出前，最好把所有触发链路都完整地过一遍，不要只抽查其中一条，这样才能确定每个环节都稳定。

　　二、QLab收不到MIDI消息的时候该怎么排查

　　如果消息一直收不到，不要急着重新安装QLab，大多数时候问题都集中在端口、通道、系统权限以及消息格式这几块，顺着去查通常会更快找到原因。

　　1、先去看看macOS系统有没有认出MIDI设备

　　打开macOS系统自带的【音频MIDI设置】工具，查看当前连接的外部设备是不是已经出现在列表里面。像USB的MIDI接口、数字调音台，还有各种虚拟MIDI驱动，如果连系统这边都看不到它们，那QLab里更不可能出现对应的端口，这个问题就得先解决掉。

　　2、检查QLab里监听的端口到底对不对

　　有不少设备会同时生成好几个MIDI端口，比如控制端口、同步端口、编辑端口等等，有时候可能错选到了别的端口上，所以虽然外部的消息一直在往外发，但QLab却始终接收不到。在这种时候，需要回到偏好设置里，确认一下当前勾选的是不是真正用来发命令的那个端口。

　　3、核对MIDI通道以及消息的类型

　　发送端用的是Channel 1，而QLab里监听的是Channel 2，这种情况下消息自然会被忽略；或者外面发出来的是Note Off，可QLab设置的是只接收Note On，那同样不会有反应。为了方便定位，可以先把QLab设成监听全部通道，看到底能不能抓进来数据，再一步步把范围缩小，找出准确的通道。

　　4、留意虚拟MIDI端口是不是发生了冲突

　　在使用LoopMIDI、IAC Driver或者其他虚拟MIDI工具的时候，同一个端口很有可能被好多个软件同时占用，特别是当你同时开着DAW、灯光控制软件和QLab的时候，很容易发生消息的冲突或者端口被重复抢夺，这些都会导致某一边的消息丢失。

　　三、怎样避免现场演出时MIDI联动突然失效

　　排练的时候一切正常，一到了正式演出就出现问题，这很多时候并不是之前的配置有错，而是系统运行的环境悄悄发生了变化。

　　1、把USB端口的名称和连接位置固定住

　　USB MIDI设备拔掉再插回去以后，它们在系统里出现的顺序有可能会变，从而影响到之前配好的端口名。演出用的电脑最好一直用固定的那几个USB接口，别临时再去换Hub或转接头，这样设备名字一变，QLab原有的MIDI设置就可能失效，导致消息走不通。

　　2、演出当中把不需要的软件都关掉

　　在后台运行着的其他DAW、MIDI监视工具或者同步软件，很可能在你不注意的时候抢占掉MIDI端口，正式演出那会儿，只留下必要的控制软件就好，这样可以减少端口被争用的风险，让MIDI通信更稳定一些。

　　3、借助MIDI Monitor之类的工具抓包分析

　　当你怀疑消息到底有没有从发送端真正发出来时，可以打开MIDI Monitor这类工具来查看实时数据，它能显示出Note、Control Change或者Program Change是不是已经发了过来，这样就能快速判断问题到底出在发送端，还是出在QLab的接收端，不至于在两头上都乱猜。

　　4、给那些非常重要的Cue多加一条备用触发方式

　　那些在演出中特别关键的灯光、音频和视频Cue，除了依靠MIDI之外，最好还保留一套键盘热键或者OSC的备用触发路径。现场的MIDI环境有时候会比较复杂，万一出现了接口断连或者干扰的情况，操作人员还能马上用手动的方式接管过去，不至于让演出中断。

　　总结

　　概括下来，在QLab里配置MIDI触发，以及当收不到消息时该怎么入手排查，整个的核心思路就是：先在QLab中打开正确的MIDI输入端口，再为每个Cue分别配好对应的MIDI消息类型、通道和编号。如果发现消息始终进不来，那就从系统设备识别、监听端口、消息格式和虚拟MIDI冲突这几个方向依次去查。等到演出前夕，再花时间做一次完整的联调测试，并借助抓包工具确认整条链路是否可靠，这样到了现场就会稳妥许多。