MIDIOutput: метод send()
Ограниченная доступность
Эта функция не является Baseline, так как она не работает во всех широко используемых браузерах.
Защищённый контекст: Эта функция доступна только в защищённых контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.
Метод send() интерфейса MIDIOutput помещает сообщения в очередь для соответствующего порта MIDI. Сообщение может быть отправлено немедленно или с необязательной отметкой времени для задержки отправки.
Синтаксис
send(data) send(data, timestamp)
Параметры
data-
Последовательность одного или более валидных сообщений MIDI. Каждый элемент представляет один байт данных.
timestampНеобязательно-
DOMHighResTimestampсо временем в миллисекундах, когда сообщение должно быть отправлено (относительноPerformance.timeOrigin).
Возвращаемое значение
None (undefined).
Исключения
TypeError-
Выбрасывается, если
dataне является допустимой последовательностью или не содержит допустимого сообщения MIDI. -
InvalidAccessErrorDOMException -
Выбрасывается, если
dataявляется сообщением системного исключения, аMIDIAccessне включил доступ к исключениям. -
InvalidStateErrorDOMException -
Выбрасывается, если порт отключён.
Примеры
В следующем примере отправляется нота до малой октавы, а затем — сообщение об отключении ноты через секунду.
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.
}
Спецификации
| Спецификация |
|---|
| Web MIDI API # dom-midioutput-send |
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
send |
43 | 79 | 108 | 30 | Нет | 43 | Нет | 30 | Нет | 4.0 | 43 |
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MIDIOutput/send