MIDIAccess

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 MIDIAccess-Interface der Web MIDI API bietet Methoden zum Auflisten von MIDI-Ein- und -Ausgabegeräten sowie zum Erlangen des Zugangs zu diesen Geräten.

MIDIAccess ist ein übertragbares Objekt.

Instanzeigenschaften

MIDIAccess.inputs Schreibgeschützt: Gibt eine Instanz von MIDIInputMap zurück, die Zugang zu allen verfügbaren MIDI-Eingangsports bietet.
MIDIAccess.outputs Schreibgeschützt: Gibt eine Instanz von MIDIOutputMap zurück, die Zugang zu allen verfügbaren MIDI-Ausgangsports bietet.
MIDIAccess.sysexEnabled Schreibgeschützt: Ein boolesches Attribut, welches anzeigt, ob die System-Exclusive-Unterstützung bei der aktuellen MIDIAccess-Instanz aktiviert ist.

Events

statechange: Wird aufgerufen, wenn ein neuer MIDI-Port hinzugefügt wird oder ein bestehender Port seinen Zustand ändert.

Beispiele

Die Methode Navigator.requestMIDIAccess() gibt ein Promise zurück, das mit einem MIDIAccess-Objekt aufgelöst wird. Informationen zu den Eingangs- und Ausgangsports werden zurückgegeben.

Wenn sich der Zustand eines Ports ändert, werden Informationen zu diesem Port in die Konsole ausgegeben.

navigator.requestMIDIAccess().then((access) => {
  // Get lists of available MIDI controllers
  const inputs = access.inputs.values();
  const outputs = access.outputs.values();

  access.onstatechange = (event) => {
    // Print information about the (dis)connected MIDI controller
    console.log(event.port.name, event.port.manufacturer, event.port.state);
  };
});

Spezifikationen

Specification
Web MIDI API # midiaccess-interface

Browser-Kompatibilität

BCD tables only load in the browser