Документация

MIDI

Этот пример вводит протокол Цифрового интерфейса музыкальных инструментов (MIDI) и как можно использовать Audio Toolbox™, чтобы взаимодействовать с MIDI-устройствами. Инструменты, описанные здесь, позволяют вам отправить и получить все сообщения MIDI, как описано протоколом MIDI. Если вы интересуетесь только отправкой и получением сообщений Изменения Управления с поверхностью управления MIDI, смотрите Интерфейс Поверхности Управления MIDI. Если вы интересуетесь использованием MIDI, чтобы управлять вашими аудио плагинами, смотрите Управление MIDI для Аудио Плагинов. Чтобы узнать больше о MIDI в целом, консультируйтесь с Ассоциацией Производителей MIDI.

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

MIDI-устройства

MIDI device является любым устройством, способным к отправке или получению сообщений MIDI. MIDI-устройства имеют входные порты, выходные порты или обоих. Протокол MIDI задает сообщения как однонаправленные. MIDI-устройство может быть реальным или виртуальным.

Audio Toolbox позволяет вам создать интерфейс к MIDI-устройству с помощью mididevice. Чтобы создать MIDI-интерфейс к определенному устройству, используйте mididevinfo, чтобы запросить вашу систему для доступных устройств. Затем создайте объект mididevice путем определения MIDI-устройства по наименованию или ID.

mididevinfo

MIDI devices available:
  ID  Direction  Interface   Name
   0   output    MMSystem   'Microsoft MIDI Mapper'
   1    input    MMSystem   'USB MIDI Interface '
   2   output    MMSystem   'Microsoft GS Wavetable Synth'
   3   output    MMSystem   'USB MIDI Interface '

device = mididevice('USB MIDI Interface ')

device = 

  mididevice connected to
     Input: 'USB MIDI Interface ' (1)
    Output: 'USB MIDI Interface ' (3)

Можно задать объект mididevice прислушаться к входным сигналам, отправить выходные сигналы или обоих. В этом примере объект mididevice получает сообщения MIDI во входном порту под названием 'USB MIDI Interface ' и отправляет сообщения MIDI от выходного порта под названием 'USB MIDI Interface '.

Сообщения MIDI

MIDI message содержит информацию, которая описывает связанное с аудио действие. Например, когда вы нажимаете клавишу на клавиатуре, соответствующее сообщение MIDI содержит 3 байта:

Это сообщение является сообщением Note On. Примечание По упоминается как имя сообщения, команда или тип.

В MATLAB^® сообщение MIDI группировано как объект midimsg и может управляться как скаляры или массивы. Чтобы создать сообщение MIDI, вызовите midimsg с типом сообщения и затем задайте обязательные параметры для определенного типа сообщения. Например, чтобы создать примечание по сообщению, задайте Type midimsg как 'NoteOn' и затем задайте необходимые входные параметры: образуйте канал, отметьте, и скорость.

channel = 1;
note = 60;
velocity = 64;
msg = midimsg('NoteOn',channel,note,velocity)

msg = 

  MIDI message:
    NoteOn          Channel: 1  Note: 60  Velocity: 64  Timestamp: 0  [ 90 3C 40 ]

Для удобства midimsg отображает тип сообщения, канал, дополнительные параметры, метку времени и созданное сообщение в шестнадцатеричной форме. Шестнадцатеричный предпочтительная форма, потому что она имеет прямую интерпретацию:

receivedMessages = midireceive(device)

receivedMessages = 

  MIDI message:
    NoteOn          Channel: 1  Note: 36  Velocity: 64  Timestamp: 15861.9  [ 90 24 40 ]
    NoteOn          Channel: 1  Note: 36  Velocity: 0   Timestamp: 15862.1  [ 90 24 00 ]

midisend(device,msg)

channelPressureMessage = midimsg('ChannelPressure',1,20)

channelPressureMessage = 

  MIDI message:
    ChannelPressure Channel: 1  ChannelPressure: 20  Timestamp: 0  [ D0 14 ]

channelPressureMessage.ChannelPressure = 37

channelPressureMessage = 

  MIDI message:
    ChannelPressure Channel: 1  ChannelPressure: 37  Timestamp: 0  [ D0 25 ]