MIDIAccess: statechange-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 statechange-Ereignis des MIDIAccess-Interfaces wird ausgelöst, wenn ein neuer MIDI-Port hinzugefügt wird oder wenn ein bestehender Port seinen Status ändert.

Syntax

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

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

onstatechange = (event) => {};

Ereignistyp

Ein MIDIConnectionEvent. Erbt von Event.

Event MIDIConnectionEvent

Ereigniseigenschaften

MIDIConnectionEvent.port Nur lesbar

Gibt eine Referenz auf eine MIDIPort-Instanz für einen Port zurück, der verbunden oder getrennt wurde.

Beispiel

Die Methode Navigator.requestMIDIAccess() gibt ein Promise zurück, das mit einem MIDIAccess-Objekt aufgelöst wird. Wenn ein Port seinen Status ändert, werden Informationen über diesen Port in der Konsole ausgegeben.

js
navigator.requestMIDIAccess().then((access) => {
  access.onstatechange = (event) => {
    console.log(event.port.name, event.port.manufacturer, event.port.state);
  };
});

Spezifikationen

Specification
Web MIDI API
# dom-midiaccess-onstatechange

Browser-Kompatibilität

BCD tables only load in the browser