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 dem MIDIInput entsprechende MIDI-Port das Empfangen von einem oder mehreren MIDI-Nachrichten abschließt. 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

Ereigniseigenschaften

Diese Schnittstelle erbt auch Eigenschaften von Event.

MIDIMessageEvent.data

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

Beispiele

Im folgenden Beispiel wird auf midimessage-Ereignisse auf allen Eingangsports gehört. Wenn eine Nachricht empfangen wird, wird die MIDIMessageEvent.data-Eigenschaft in die Konsole ausgegeben.

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

Spezifikationen

Specification
Web MIDI API
# dom-midiinput-onmidimessage

Browser-Kompatibilität