MIDIPort: open()-Methode
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.
Die open()-Methode der MIDIPort-Schnittstelle macht das mit diesem MIDIPort verbundene MIDI-Gerät explizit verfügbar.
Wenn der Port erfolgreich geöffnet wird, wird ein neues MIDIConnectionEvent in die MIDIPort-statechange- und MIDIAccess-statechange-Ereignisse eingereiht, und die MIDIPort.connection-Eigenschaft wird auf "open" gesetzt.
Falls der Port bereits geöffnet ist, wenn diese Methode aufgerufen wird, wird das Promise erfolgreich aufgelöst.
Syntax
open()
Parameter
Keine.
Rückgabewert
Ein Promise, das aufgelöst wird, sobald der Zugriff auf den Port erfolgreich erlangt wurde.
Ausnahmen
NotAllowedErrorDOMException-
Das Promise wird mit diesem Fehler abgelehnt, wenn der Port nicht verfügbar ist und nicht geöffnet werden kann.
Beispiele
Das folgende Beispiel zeigt, wie ein Ausgangsport geöffnet wird.
const output = midiAccess.outputs.get(portID);
output.open(); // opens the port
Spezifikationen
| Specification |
|---|
| Web MIDI API # dom-midiport-open |