MIDIPort: open() メソッド

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

MIDIPort インターフェイスの open() メソッドは、この MIDIPort に接続された MIDI デバイスを明示的に利用可能にします。

ポートを開くのに成功したら、新しい MIDIConnectionEventMIDIPort statechangeMIDIAccess statechange イベントに渡され、MIDIPort.connection プロパティが "open" になります。

このメソッドが呼ばれたときにポートが既に開かれている場合は、Promise は正常に解決します。

構文

js
open()

引数

なし

返値

ポートへのアクセスを正常に得たら解決する Promise を返します。

例外

InvalidAccessError DOMException

ポートが利用不可能で開けない場合、Promise はこのエラーで拒否されます。

以下の例では、出力ポートを開きます。

js
const output = midiAccess.outputs.get(portID);
output.open(); // ポートを開く

仕様書

Specification
Web MIDI API
# dom-midiport-open

ブラウザーの互換性

BCD tables only load in the browser