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

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more support for this feature? Tell us why.

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

Spezifikation
Web MIDI API
# dom-midiinput-onmidimessage

Browser-Kompatibilität