MIDIInput: midimessage-Ereignis

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Das midimessage-Ereignis der Web MIDI API wird ausgelöst, wenn der MIDI-Port, der diesem MIDIInput entspricht, das Empfangen von einem oder mehreren MIDI-Nachrichten beendet. Eine Instanz von MIDIMessageEvent, die die empfangene Nachricht enthält, wird an den Ereignis-Handler übergeben.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignis-Handler-Eigenschaft.

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

onmidimessage = (event) => {};

Ereignistyp

Ein MIDIMessageEvent. Erbt von Event.

Event MIDIMessageEvent

Ereigniseigenschaften

Diese Schnittstelle erbt auch Eigenschaften von Event.

MIDIMessageEvent.data

Ein Uint8Array, das die Datenbytes einer einzelnen MIDI-Nachricht enthält. Weitere Informationen zur Form finden Sie in der MIDI-Spezifikation.

Beispiele

Im folgenden Beispiel wird auf allen Eingangsports nach midimessage-Ereignissen gelauscht. Wenn eine Nachricht empfangen wird, wird die Eigenschaft MIDIMessageEvent.data in der Konsole ausgegeben.

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

Spezifikationen

Specification
Web MIDI API
# dom-midiinput-onmidimessage

Browser-Kompatibilität

BCD tables only load in the browser