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 zu den MIDIPort- und MIDIAccess-statechange Ereignissen hinzugefügt, und die MIDIPort.connection-Eigenschaft wird auf "open" gesetzt.

Wenn der Port bereits geöffnet ist, wenn diese Methode aufgerufen wird, wird das Promise erfolgreich aufgelöst.

Syntax

js
open()

Parameter

Keine.

Rückgabewert

Ein Promise, das aufgelöst wird, sobald der Zugriff auf den Port erfolgreich gewährt wurde.

Ausnahmen

InvalidAccessError DOMException

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.

js
const output = midiAccess.outputs.get(portID);
output.open(); // opens the port

Spezifikationen

Specification
Web MIDI API
# dom-midiport-open

Browser-Kompatibilität

BCD tables only load in the browser