Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 abgeschlossen hat. 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 legen Sie eine Ereignis-Handler-Eigenschaft fest.

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 zu seiner Form finden Sie in der MIDI-Spezifikation.

Beispiele

Im folgenden Beispiel wird auf midimessage Ereignisse an allen Eingangsports gehorcht. 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