Web MIDI API

Web MIDI API подключается к устройствам Musical Instrument Digital Interface (MIDI) и взаимодействует с ними.

Интерфейсы обрабатывают практические аспекты отправки и получения сообщений MIDI. Поэтому API можно использовать для музыкальных и не музыкальных целей, с любым устройством MIDI, подключённым к вашему компьютеру.

MIDIInputMap

Представляет все доступные порты ввода MIDI.

MIDIOutputMap

Представляет все доступные порты вывода MIDI.

MIDIAccess

Предоставляет методы для перечисления устройств ввода и вывода, а также для доступа к отдельному устройству.

MIDIPort

Представляет отдельный порт MIDI.

MIDIInput

Предоставляет метод для работы с сообщениями MIDI из порта ввода.

MIDIOutput

Очередь сообщений для связанного порта MIDI. Сообщения могут быть отправлены немедленно или после заданной задержки.

MIDIMessageEvent

Событие, передаваемое в MIDIInput midimessage событие.

MIDIConnectionEvent

Событие, передаваемое в MIDIAccess statechange и MIDIPort statechange события, когда порт становится доступным или недоступным.

Доступ к API запрашивается с помощью метода navigator.requestMIDIAccess().

• Метод должен вызываться в безопасном контексте.
• Доступ может быть ограничен политикой HTTP midi политики разрешений.
• Пользователь должен явно предоставить разрешение на использование API через механизм, специфичный для пользователя агента, или ранее предоставить разрешение. Обратите внимание, что если доступ запрещён политикой разрешений, то он не может быть предоставлен пользователем.

Статус разрешения можно запросить, используя метод API разрешений navigator.permissions.query(), передав описатель разрешения с разрешением midi и (необязательным) свойством sysex:

navigator.permissions.query({ name: "midi", sysex: true }).then((result) => {
  if (result.state === "granted") {
    // Access granted.
  } else if (result.state === "prompt") {
    // Using API will prompt for permission
  }
  // Permission was denied by user prompt or permission policy
});

Метод navigator.requestMIDIAccess() возвращает промис, который разрешается в объект MIDIAccess, который затем можно использовать для доступа к устройству MIDI. Метод должен вызываться в безопасном контексте.

let midi = null; // global MIDIAccess object
function onMIDISuccess(midiAccess) {
  console.log("MIDI ready!");
  midi = midiAccess; // store in the global (in real usage, would probably keep in an object instance)
}

function onMIDIFailure(msg) {
  console.error(`Failed to get MIDI access - ${msg}`);
}

navigator.requestMIDIAccess().then(onMIDISuccess, onMIDIFailure);

В этом примере список портов ввода и вывода извлекается и выводится в консоль.

function listInputsAndOutputs(midiAccess) {
  for (const entry of midiAccess.inputs) {
    const input = entry[1];
    console.log(
      `Input port [type:'${input.type}']` +
        ` id:'${input.id}'` +
        ` manufacturer:'${input.manufacturer}'` +
        ` name:'${input.name}'` +
        ` version:'${input.version}'`,
    );
  }

  for (const entry of midiAccess.outputs) {
    const output = entry[1];
    console.log(
      `Output port [type:'${output.type}'] id:'${output.id}' manufacturer:'${output.manufacturer}' name:'${output.name}' version:'${output.version}'`,
    );
  }
}

В этом примере все сообщения MIDI ввода выводятся в консоль.

function onMIDIMessage(event) {
  let str = `MIDI message received at timestamp ${event.timeStamp}[${event.data.length} bytes]: `;
  for (const character of event.data) {
    str += `0x${character.toString(16)} `;
  }
  console.log(str);
}

function startLoggingMIDIInput(midiAccess) {
  midiAccess.inputs.forEach((entry) => {
    entry.onmidimessage = onMIDIMessage;
  });
}

• Введение в Web MIDI
• Создание музыки в браузере