MIDI-MT - Файлы конфигурации приложения

Файл конфигурации

• Секция общей конфигурации

• Настройки модулей

• Секция конфигурации элементов управления “units”

• Пример конфигурации элементов управления

Файл конфигурации имеет популярный Json формат и для его изменения можно воспользоваться любым текстовым редактором. Рабочий пример конфигурационного файла также входит в дистрибутив. Найти его вы можете в папке установки приложения, копия настроенной конфигурации находиться в под-папке docs с именем «MidiController.cnf».

Основные параметры файла конфигурации можно настроить из запускаемого диалога при выборе пункта меню «Старт». Вы также можете настроить эти параметры непосредственно при редактировании файла конфигурации.

Секция общей конфигурации

{
  "config": {
    "name": "MidiController",
    "autostart": true,
    "build": "1.0.6.3"
  },
  "units":[... описание элементов управления контроллера...]
}

Более подробно значения глобальных параметров и их взаимосвязь описаны в разделе Настройки

Настройки модулей

Вся информация о настройке модулей находится в общем конфигурационном файле. Также, возможно жёстко переопределить настройку конкретного модуля, расположив одноименный с модулем файл настроек с расширением .json в том же каталоге. Пример на картинке ниже.

JSON секции настроек модулей находяться в описании самих модулей.

Секция конфигурации элементов управления “units”

Строка описания элемента управления выглядит следующим образом:

{
    "scene":177,       // сцена контрола
    "id":22,           // номер контрола
    "type":1,          // тип контрола
    "target":254,      // группа | назначение
    "longtarget":12,   // назначение
    "onoff": false,    // последние значение
    "value": 2,        // последние значение
    "apps": [          // список приложений для управления Аудио сессиями
       "App1",
       "App2"
    ]
}

Сцена (scene), в конфигурации указывается реальный Scene MIDI ID.
Сцена это выбранный пресет, в типовом контроллере как правило 4 сцены:

ID (id), MIDI идентификатор контрола, тут надеюсь всё понятно.

Тип (type) контрола:

Назначение (target,longtarget), назначение полезной нагрузки контрола.
Для кнопок, первое значение, target - это быстрое нажатие, второе значение, longtarget - длинное нажатие. Если нет необходимости использовать длинное нажатие, присвойте свойству longtarget значение 255. Для других типов контролов, второе значение не обрабатывается, но требует установленного значения.

Также, значение target может обозначать отношение к группе, как в случаях с группами Аудио сессии, Мультимедийные клавиши, Управление светом и Умный Дом. В этом случае, значение longtarget определяет полезную нагрузку.

Рабочий пример конфигурации элементов управления

{
    ....,
    /* настройка для сцены 2 */

    "units":[
        {"scene":177,"id":22,"type":0,"target":0,"longtarget":255},
        {"scene":177,"id":13,"type":1,"target":1,"longtarget":255},
        {"scene":177,"id":31,"type":3,"target":3,"longtarget":255},
    ]
}