MIDIInput: midimessage 事件

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

当与此 MIDIInput 对应的 MIDI 端口接收完一个或多个 MIDI 消息时，Web MIDI API 的 midimessage 事件将被触发。一个包含所接收消息的 MIDIMessageEvent 实例将传递给事件处理程序。

语法

在诸如 addEventListener() 之类的方法中使用事件名称，或设置事件处理程序属性。

addEventListener("midimessage", (event) => { })

onmidimessage = (event) => { }

此接口还继承了 Event 的属性。

MIDIMessageEvent.data: 一个包含单个 MIDI 消息数据字节的 Uint8Array。有关其格式的更多信息，请参阅 MIDI 规范。

在以下示例中，所有输入端口都监听 midimessage 事件。当收到消息时，MIDIMessageEvent.data 属性将打印到控制台。

inputs.forEach((input) => {
  input.onmidimessage = (message) => {
    console.log(message.data);
  };
});

规范
Web MIDI API # dom-midiinput-onmidimessage

此页面由 MDN 贡献者上次修改于 ⁨2025 年 5 月 2 日⁩。