MIDIInput: midimessage イベント
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
Web MIDI API の midimessage
イベントは、この MIDIInput
に対応する MIDI ポートで 1 個以上の MIDI メッセージの受信が完了した時発火します。受信したメッセージが格納された MIDIMessageEvent
のインスタンスがイベントハンドラーに渡されます。
構文
addEventListener()
のようなメソッドでイベント名を用いるか、イベントハンドラープロパティを設定します。
js
addEventListener("midimessage", (event) => {});
onmidimessage = (event) => {};
イベント型
MIDIMessageEvent
です。Event
を継承しています。
イベントプロパティ
このインターフェイスは Event
からもプロパティを継承しています。
MIDIMessageEvent.data
-
1 個の MIDI メッセージのデータバイト列が格納された
Uint8Array
です。構造の詳細については、MIDI の仕様書を参照してください。
例
以下の例では、すべての入力ポートで midimessage
イベントを監視します。メッセージを受信したら、MIDIMessageEvent.data
プロパティをコンソールに出力します。
js
inputs.forEach((input) => {
input.onmidimessage = (message) => {
console.log(message.data);
};
});
仕様書
Specification |
---|
Web MIDI API # dom-midiinput-onmidimessage |
ブラウザーの互換性
BCD tables only load in the browser