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 der MIDIAccess Schnittstelle wird ausgelöst, wenn ein neuer MIDI-Port hinzugefügt wird oder sich der Status eines bestehenden Ports ändert.

Syntax

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

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

onstatechange = (event) => { }

Ereignistyp

Ein MIDIConnectionEvent. Erbt von Event.

Event MIDIConnectionEvent

Ereigniseigenschaften

MIDIConnectionEvent.port Schreibgeschützt

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 sich der Status eines Ports ändert, werden Informationen über diesen Port in die 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