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
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.
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