MIDIPort: open() メソッド
利用可能性は限定的
この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
MIDIPort インターフェイスの open() メソッドは、この MIDIPort に接続された MIDI デバイスを明示的に利用可能にします。
ポートを開くのに成功したら、新しい MIDIConnectionEvent が MIDIPort statechange と MIDIAccess statechange イベントに渡され、MIDIPort.connection プロパティが "open" になります。
このメソッドが呼ばれたときにポートが既に開かれている場合は、Promise は正常に解決します。
構文
js
open()
引数
なし
返値
ポートへのアクセスを正常に得たら解決する Promise を返します。
例外
InvalidAccessErrorDOMException-
ポートが利用不可能で開けない場合、Promise はこのエラーで拒否されます。
例
以下の例では、出力ポートを開きます。
js
const output = midiAccess.outputs.get(portID);
output.open(); // ポートを開く
仕様書
| 仕様書 |
|---|
| Web MIDI API # dom-midiport-open |