Java Sound API收发MIDI Sysex消息:如何接收设备返回的SysEx消息
实现MIDI设备返回SysEx消息的接收逻辑
现有代码的核心问题
你当前的代码只建立了向目标MIDI设备发送消息的链路,完全没有搭建接收设备上行消息的通道:
- 你通过
device.getReceiver()获取的对象是MIDI设备的输入接口专用接收端,作用是把你生成的消息转发给目标设备,无法承接设备向外发送的返回消息 - 发送完消息就立即关闭接收端、没有预留消息回传的等待窗口,即使有回传链路也收不到响应
具体实现步骤
1. 搭建设备上行消息的接收链路
Java Sound API中,MIDI设备向外输出的所有消息(包括返回的SysEx)都会通过设备内置的Transmitter对外广播,你需要给这个Transmitter挂载自定义的消息接收端,才能捕获到设备发出来的内容:
- 从打开的MidiDevice实例中获取设备的Transmitter对象
- 自定义实现
Receiver接口,在重写的send方法中筛选出所有类型为SysexMessage的消息,做对应的数据解析、打印或业务处理
2. 调整消息发送与等待的时序逻辑
- 先完成接收端的挂载,再向设备发送SysEx指令,避免错过设备在发送链路建立前就返回的消息
- 发送完成后不要立刻关闭所有资源,预留200-500ms的等待窗口(具体时长根据目标设备的响应速度调整),给设备留出发送回包的时间
- 等待结束后再按顺序释放所有占用的MIDI资源,避免设备未完成回传就被强制断开
3. 改造后的完整可运行示例代码
try { MidiDevice device = MidiSystem.getMidiDevice(info); // 保留你原有逻辑中定义的SysEx发送指令 byte[] dataAlone = { (byte) 0xF0, (byte) 0xB0, (byte) 0x63, (byte) 0x00, (byte) 0xB0, (byte) 0x62, (byte) 0x0C, (byte) 0xB0, (byte) 0x60, (byte) 0x7F, (byte) 0xF7 }; SysexMessage message1 = new SysexMessage(dataAlone, dataAlone.length); // 打开MIDI设备 device.open(); // 第一步:搭建接收链路——获取设备的上行Transmitter Transmitter deviceTransmitter = device.getTransmitter(); // 给Transmitter挂载自定义接收端,捕获设备返回的所有消息 deviceTransmitter.setReceiver(new Receiver() { @Override public void send(MidiMessage message, long timeStamp) { // 筛选SysEx类型的返回消息 if (message instanceof SysexMessage) { SysexMessage sysexReply = (SysexMessage) message; byte[] replyData = sysexReply.getData(); // 此处可替换为实际业务逻辑,调试阶段可直接打印消息内容 System.out.println("收到设备返回的SysEx消息,总长度:" + replyData.length); // 将消息转十六进制格式打印,便于对照协议文档调试 StringBuilder hexStr = new StringBuilder(); for (byte b : replyData) { hexStr.append(String.format("%02X ", b)); } System.out.println("消息内容:" + hexStr.toString().trim()); } } @Override public void close() { // 自定义接收端无特殊资源需要释放,可空实现 } }); // 第二步:建立发送链路——获取设备的输入Receiver,用来给设备下发指令 Receiver deviceInputReceiver = device.getReceiver(); deviceInputReceiver.send(message1, -1); // 第三步:预留等待窗口,给设备预留回传响应的时间 Thread.sleep(500); // 第四步:按顺序释放所有占用的MIDI资源 deviceTransmitter.close(); deviceInputReceiver.close(); device.close(); } catch (InvalidMidiDataException | MidiUnavailableException | InterruptedException e) { System.out.println(e); }
关键注意事项
- Receiver和Transmitter的角色不要混淆:Receiver是用来接收输入消息的端口,Transmitter是用来向外输出消息的端口;下发消息时你拿设备的Receiver,收设备返回的消息时,要挂自己的Receiver到设备的Transmitter上
- 确认你获取的MidiDevice实例和目标硬件是同一连通端口,避免出现设备实例匹配错误、消息发对了但接收端口不对应的问题
- 若长时间等不到返回消息,可检查是否有其他本地MIDI应用占用了该设备的Transmitter通道。MIDI设备的Transmitter同一时间只能挂载一个Receiver,这也是为什么你当前能在其他MIDI应用中看到设备回传的SysEx消息、但自己代码收不到的核心原因
内容的提问来源于stack exchange,提问作者Olivier Rivard
相关产品推荐
相关产品推荐

