MIDIInput:midimessage 事件

可用性有限

此功能不是基线功能,因为它在一些使用最广泛的浏览器中无法正常工作。

安全上下文:此功能仅在安全上下文(HTTPS)中可用,并且仅在某些或所有支持的浏览器中可用。

当与该MIDIInput对应的 MIDI 端口完成接收一个或多个 MIDI 消息时,Web MIDI APImidimessage事件会被触发。包含已接收消息的MIDIMessageEvent实例将传递给事件处理程序。

语法

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

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

onmidimessage = (event) => {};

事件类型

事件属性

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

MIDIMessageEvent.data

一个Uint8Array,包含单个 MIDI 消息的数据字节。有关其形式的更多信息,请参阅MIDI 规范

示例

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

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

规范

规范
Web MIDI API
# dom-midiinput-onmidimessage

浏览器兼容性

BCD 表仅在浏览器中加载