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.
addEventListener("midimessage", (event) => { })
onmidimessage = (event) => { }
Ereignistyp
Ein MIDIMessageEvent
. Erbt von Event
.
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.
inputs.forEach((input) => {
input.onmidimessage = (message) => {
console.log(message.data);
};
});
Spezifikationen
Specification |
---|
Web MIDI API # dom-midiinput-onmidimessage |