MIDIOutput: send() Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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
| Spezifikation |
|---|
| Web MIDI API # dom-midioutput-send |