MIDIOutput: send() Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die send() Methode der MIDIOutput Schnittstelle stellt Nachrichten für den entsprechenden MIDI-Port in die Warteschlange. Die Nachricht kann sofort gesendet werden oder mit einem optionalen Zeitstempel, um das Senden zu verzögern.
Syntax
send(data)
send(data, timestamp)
Parameter
data-
Eine Sequenz von einem oder mehreren gültigen MIDI-Nachrichten. Jeder Eintrag repräsentiert ein einzelnes Byte an Daten.
timestampOptional-
Ein
DOMHighResTimestampmit der Zeit in Millisekunden, wann die Nachricht gesendet werden soll (relativ zuPerformance.timeOrigin).
Rückgabewert
Keiner (undefined).
Ausnahmen
TypeError-
Wird ausgelöst, wenn
datakeine gültige Sequenz ist oder keine gültige MIDI-Nachricht enthält. NotAllowedErrorDOMException-
Wird ausgelöst, wenn
dataeine systemexklusive Nachricht ist und derMIDIAccesskeinen exklusiven Zugriff aktiviert hat. InvalidStateErrorDOMException-
Wird ausgelöst, wenn der Port getrennt ist.
Beispiele
Im folgenden Beispiel wird eine mittlere C-Note sofort gesendet, gefolgt von einer Note-off-Nachricht eine Sekunde später.
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.
}
Spezifikationen
| Specification |
|---|
| Web MIDI API # dom-midioutput-send |