MIDIAccess

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

Web MIDI APIMIDIAccess インターフェイスは、MIDI の入力デバイスや出力デバイスを列挙するメソッドと、それらのデバイスへのアクセスを得るメソッドを提供します。

EventTarget MIDIAccess

インスタンスプロパティ

MIDIAccess.inputs 読取専用

任意の利用可能な MIDI 入力ポートへのアクセスを提供する MIDIInputMap のインスタンスを返します。

MIDIAccess.outputs 読取専用

任意の利用可能な MIDI 出力ポートへのアクセスを提供する MIDIOutputMap のインスタンスを返します。

MIDIAccess.sysexEnabled 読取専用

現在の MIDIAccess インスタンスでシステムエクスクルーシブへの対応が有効かどうかを表す論理値の属性です。

イベント

MIDIAccess.statechange_event

新しい MIDI ポートが追加されるか、既存のポートの状態が変わると、毎回呼ばれます。

Navigator.requestMIDIAccess() メソッドが MIDIAccess オブジェクトで解決する Promise を返します。入力ポートおよび出力ポートの情報が返されます。

ポートの状態が変わると、そのポートの情報をコンソールに出力します。

js
navigator.requestMIDIAccess().then((access) => {
  // 利用可能な MIDI コントローラーのリストを取得する
  const inputs = access.inputs.values();
  const outputs = access.outputs.values();

  access.onstatechange = (event) => {
    // この接続 (または切断) された MIDI コントローラーの情報を出力する
    console.log(event.port.name, event.port.manufacturer, event.port.state);
  };
});

仕様書

Specification
Web MIDI API
# midiaccess-interface

ブラウザーの互換性

BCD tables only load in the browser