Spec-Zone.ru › Web APIs

MIDIOutput: метод send()

Ограниченная доступность

Эта функция не является Baseline, так как она не работает во всех широко используемых браузерах.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Защищённый контекст: Эта функция доступна только в защищённых контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.

Метод send() интерфейса MIDIOutput помещает сообщения в очередь для соответствующего порта MIDI. Сообщение может быть отправлено немедленно или с необязательной отметкой времени для задержки отправки.

Синтаксис

send(data)
send(data, timestamp)

Параметры

data

Последовательность одного или более валидных сообщений MIDI. Каждый элемент представляет один байт данных.

timestamp Необязательно

DOMHighResTimestamp со временем в миллисекундах, когда сообщение должно быть отправлено (относительно Performance.timeOrigin).

Возвращаемое значение

None (undefined).

Исключения

TypeError

Выбрасывается, если data не является допустимой последовательностью или не содержит допустимого сообщения MIDI.

InvalidAccessError DOMException

Выбрасывается, если data является сообщением системного исключения, а MIDIAccess не включил доступ к исключениям.

InvalidStateError DOMException

Выбрасывается, если порт отключён.

Примеры

В следующем примере отправляется нота до малой октавы, а затем — сообщение об отключении ноты через секунду.

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API