MIDIAccess

可用性有限

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

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

MIDIAccess 介面屬於 Web MIDI API,它提供了列出 MIDI 輸入和輸出裝置的方法,以及獲取這些裝置的訪問許可權。

MIDIAccess 是一個可轉移物件

EventTarget MIDIAccess

例項屬性

MIDIAccess.inputs 只讀

返回一個 MIDIInputMap 例項,它提供了對所有可用 MIDI 輸入埠的訪問。

MIDIAccess.outputs 只讀

返回一個 MIDIOutputMap 例項,它提供了對所有可用 MIDI 輸出埠的訪問。

MIDIAccess.sysexEnabled 只讀

一個布林屬性,指示當前 MIDIAccess 例項是否啟用了系統獨佔支援。

事件

statechange

每當新增新的 MIDI 埠或現有埠狀態更改時呼叫。

示例

Navigator.requestMIDIAccess() 方法返回一個 promise,該 promise 解析為一個 MIDIAccess 物件。其中包含有關輸入和輸出埠的資訊。

當埠狀態發生變化時,有關該埠的資訊會列印到控制檯。

js
navigator.requestMIDIAccess().then((access) => {
  // Get lists of available MIDI controllers
  const inputs = access.inputs.values();
  const outputs = access.outputs.values();

  access.onstatechange = (event) => {
    // Print information about the (dis)connected MIDI controller
    console.log(event.port.name, event.port.manufacturer, event.port.state);
  };
});

規範

規範
Web MIDI API
# midiaccess-interface

瀏覽器相容性