MIDIPort: open() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

open() 方法是 MIDIPort 介面的一部分,它使連線到此 MIDIPort 的 MIDI 裝置明確可用。

如果埠成功開啟,一個新的 MIDIConnectionEvent 將被排入 MIDIPortstatechange 事件和 MIDIAccessstatechange 事件佇列中,並且 MIDIPort.connection 屬性將更改為 "open"

如果呼叫此方法時埠已經開啟,則 promise 將成功解決。

語法

js
open()

引數

無。

返回值

一旦成功獲得對埠的訪問許可權,promise 就會解決。

異常

InvalidAccessError DOMException

如果埠不可用且無法開啟,則 promise 將被此錯誤拒絕。

示例

以下示例展示瞭如何開啟一個輸出埠。

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

規範

規範
Web MIDI API
# dom-midiport-open

瀏覽器相容性