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

浏览器兼容性