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

イベントプロパティ

このインターフェイスは 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