MIDIInput: midimessage 事件

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

當與此 MIDIInput 對應的 MIDI 埠接收完一個或多個 MIDI 訊息時,Web MIDI API 的 midimessage 事件將被觸發。一個包含所接收訊息的 MIDIMessageEvent 例項將傳遞給事件處理程式。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

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

onmidimessage = (event) => { }

事件型別

一個 MIDIMessageEvent。繼承自 Event

Event MIDIMessageEvent

事件屬性

此介面還繼承了 Event 的屬性。

MIDIMessageEvent.data

一個包含單個 MIDI 訊息資料位元組的 Uint8Array。有關其格式的更多資訊,請參閱 MIDI 規範

示例

在以下示例中,所有輸入埠都監聽 midimessage 事件。當收到訊息時,MIDIMessageEvent.data 屬性將列印到控制檯。

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

規範

規範
Web MIDI API
# dom-midiinput-onmidimessage

瀏覽器相容性