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

1. Соедините MIDI-устройство и затем запустите MATLAB

Перед стартовым MATLAB соедините свою поверхность управления MIDI с вашим компьютером и включите его. Для инструкций по связи см. инструкции для своего MIDI-устройства. Если при запуске MATLAB прежде, чем соединить ваше устройство, MATLAB не может распознать ваше устройство, когда вы соединяете его. Чтобы исправить проблему, перезапустите MATLAB с устройством, уже соединенным.

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

Используйте функцию midiid, чтобы определить имя устройства и контрольные числа вашей поверхности управления MIDI. После того, как вы вызываете midiid, он продолжает слушать, пока он не получает сообщение Изменения Управления. Когда это получает сообщение Изменения Управления, это возвращает контрольное число, сопоставленное с номером MIDI-контроллера, которым вы управляли, и опционально возвращаете имя устройства своей поверхности управления MIDI. Производитель и хостовая операционная система определяют имя устройства. Смотрите Контрольные числа для объяснения того, как MATLAB вычисляет контрольное число.

Чтобы установить имя устройства по умолчанию, смотрите MIDI-устройство Значения по умолчанию Набора.

 Просмотрите пример

[controlNumber,deviceName] = midiid;

3. Создайте прослушиватель для сообщений изменения управления

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

 Просмотрите пример

controlNum1 = midiid;
[controlNum2,deviceName] = midiid;
initialControlValues = [0.1,0.9];

midicontrolsObject = midicontrols([controlNum1,controlNum2], ...
    initialControlValues, ...
    'MIDIDevice',deviceName);

4. Получите текущие значения управления

Используйте функцию midiread, чтобы запросить ваш объект midicontrols для текущих значений управления. midiread возвращает матрицу со значениями, соответствующими всем контроллерам, которые слушает объект midicontrols. Обычно вы хотите поместить midiread в цикл аудиопотока для непрерывного обновления.

 Просмотрите пример

[controlNumber, deviceName] = midiid;
initialControlValue = 1;
midicontrolsObject = midicontrols(controlNumber,initialControlValue,'MIDIDevice',deviceName);

% Create a dsp.AudioFileReader System object™ with default settings. Create
% an audioDeviceWriter System object and specify the sample rate.
fileReader = dsp.AudioFileReader('RockDrums-44p1-stereo-11secs.mp3');
deviceWriter = audioDeviceWriter(...
    'SampleRate',fileReader.SampleRate);

% In an audio stream loop, read an audio signal frame from the file, apply
% gain specified by the control on your MIDI device, and then write the
% frame to your audio output device. By default, the control value returned
% by midiread is normalized.
while ~isDone(fileReader)
    audioData = step(fileReader);
    
    controlValue = midiread(midicontrolsObject);
    
    gain = controlValue*2;
    audioDataWithGain = audioData*gain;
    
    play(deviceWriter,audioDataWithGain);
end

% Close the input file and release your output device.
release(fileReader);
release(deviceWriter);

5. Синхронизируйте двунаправленные поверхности управления MIDI

Можно использовать midisync, чтобы отправить сообщения Изменения Управления в поверхность управления MIDI. Если поверхность управления MIDI двунаправлена, она настраивает заданные контроллеры. Одно важное использование midisync должно установить позиции контроллера на вашей поверхности управления MIDI к начальным значениям.

 Просмотрите пример

[controlNumber,deviceName] = midiid;
initialControlValue = 0.5;
midicontrolsObject = midicontrols(controlNumber,initialControlValue,'MIDIDevice',deviceName);

midisync(midicontrolsObject);

Другое важное использование midisync должно обновить вашу поверхность управления MIDI, если значения управления настроены в цикле аудиопотока. В этом случае вы вызываете midisync и с вашим объектом midicontrols и с обновленными значениями управления.

 Просмотрите пример

[controlNumber, deviceName] = midiid;
initialControlValue = 0.5;
midicontrolsObject = midicontrols(controlNumber,initialControlValue);
fileReader = dsp.AudioFileReader('Ambiance-16-44p1-mono-12secs.wav');
deviceWriter = audioDeviceWriter(...
    'SampleRate',fileReader.SampleRate);

% Synchronize specified initial value with the MIDI control surface.
midisync(midicontrolsObject);          

while ~isDone(fileReader)
    audioData = step(fileReader);
    controlValue = midiread(midicontrolsObject);
    gain = controlValue*2;
    audioDataWithGain = audioData*gain;
    
    % Check if max output is above a given threshold.
    if max(audioDataWithGain) > 0.7
        
        % Force new control value to be nonnegative.
        newControlValue = max(0,controlValue-0.5);
        
        % Send a Control Change message to the MIDI control surface.
        midisync(midicontrolsObject,newControlValue)
    end
    
    play(deviceWriter,audioDataWithGain);
end

release(fileReader);
release(deviceWriter);

midisync является также мощным инструментом в системах, которые также включают пользовательские интерфейсы (UIs), так, чтобы, когда одно управление изменяется, другое управление отследило его. Как правило, вы реализуете такое отслеживание путем установки функций обратного вызова на обоих объект midicontrols (использующий midicallback) и управление пользовательского интерфейса. Коллбэк для объекта midicontrols отправляет новые значения в управление пользовательского интерфейса. Пользовательский интерфейс использует midisync, чтобы отправить новые значения в объект midicontrols и поверхность управления MIDI. Смотрите midisync для примеров.

Альтернатива потоковой обработке

Можно использовать midicallback в качестве альтернативы размещению midiread в цикле аудиопотока. Если объект midicontrols получает сообщение Изменения Управления, midicallback автоматически вызывает заданный указатель на функцию. Функция обратного вызова обычно вызывает midiread, чтобы определить новое значение средств управления MIDI. Можно использовать этот коллбэк когда это необходимо MIDI-контроллер, чтобы инициировать действие, такое как обновление пользовательского интерфейса. Используя этот подход предотвращает наличие программы MATLAB, постоянно запускающейся в командном окне.

Установите MIDI-устройство по умолчанию

Можно установить MIDI-устройство по умолчанию в среде MATLAB при помощи функции setpref. Используйте midiid, чтобы определить имя устройства, и затем использовать setpref, чтобы установить настройку.

[~,deviceName] = midiid

Move the control you wish to identify; type ^C to abort.
Waiting for control message... done

deviceName =

BCF2000

setpref('midi','DefaultDevice',deviceName)

Если вы не устанавливаете эту настройку, MATLAB и хостовая операционная система выбирают устройство для вас. Однако такой автовыбор может вызвать непредсказуемые результаты, потому что многим компьютерам установили "виртуальный" (программное обеспечение) MIDI-устройства, что вы не можете знать. Для предсказуемого поведения, набор настройка.

Контрольные числа

MATLAB задает контрольные числа как (MIDI channel number) × 1000 + (MIDI controller number).

Ваше MIDI-устройство определяет значения MIDI channel number и MIDI controller number.