Web MIDI API
The send() method of the MIDIOutput interface queues messages for the corresponding MIDI port. The message can be sent immediately, or with an optional timestamp to delay sending.
Syntax
send(data)
send(data, timestamp)
Parameters
data- : A sequence of one or more valid MIDI messages. Each entry represents a single byte of data.
timestamp- : A DOMHighResTimestamp with the time in milliseconds when the message should be sent (relative to Performance.timeOrigin).
Return value
None (undefined).
Exceptions
- TypeError
- : Thrown if
datais not a valid sequence, or does not contain a valid MIDI message.
- : Thrown if
NotAllowedErrorDOMException- : Thrown if
datais a system exclusive message, and the MIDIAccess did not enable exclusive access.
- : Thrown if
InvalidStateErrorDOMException- : Thrown if the port is disconnected.
Examples
In the following example a middle C note is sent immediately, followed by a note off message one second later.
function sendMiddleC(midiAccess, portID) {
const noteOnMessage = [0x90, 60, 0x7f]; // Note on middle C, full velocity
const output = midiAccess.outputs.get(portID);
output.send(noteOnMessage); // Omitting the timestamp means send immediately.
output.send([0x80, 60, 0x40], window.performance.now() + 1000.0); // timestamp = now + 1000ms.
}
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
