Запуск клиентского приложения TrueConf с настройками из файла JSON
Часто перед системным администратором возникает задача эффективно распространить единые настройки на большое количество экземпляров приложения в корпоративной сети.
Одним из решений данной задачи является сохранение настроек в файле определённого формата (например, JSON, XML или CSV) и размещение его на каждом целевом компьютере.
Начиная с версии 8.2.0, клиентское приложение TrueConf поддерживает возможность запуска с параметрами, описанными в файле JSON. Далее мы покажем, как подготовить такой файл.
Как это работает:
- Если пользователь добавил файл настроек, то приложение при запуске считает его и заменит свои настройки значениями из файла (что будет видно в меню Настройки).
- Если пользователь после создания/изменения файла настроек задал настройки в приложении вручную, то они имеют приоритет и будут использоваться в дальнейшем. Файл json при этом не перепишется, но просто будет игнорироваться до последующего изменения (см. п.3).
- Если файл json уже создан, то для переопределения настроек с его помощью достаточно просто обновить время его изменения. Например, поставить и удалить какой-то символ и пересохранить файл.
Создание файла с параметрами
В первую очередь необходимо создать файл JSON и перечислить в нём интересующие настройки как пары "ключ":"значение"
, где:
"ключ"
– идентификатор, определяющий какой параметр вы хотите задать;
"значение"
– значение данного параметра;
Подробнее о формате JSON читайте в официальной документации.
PDF-файл с полным списком ключей, их значений, и настроек которые они определяют вы можете скачать по следующей ссылке:
Пример того, как может выглядеть JSON-файл с клиентскими настройками:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
{ "selfViewMirror":false, "invertedPTZControl":false, "audioPlayLevel":0.6, "aecEnable":true, "noiseSupEnable":true, "audioDumpEnable":false, "allowHIDControl":false, "corporateServer":true, "canAskForServerSelector":false, "enableAutologin":true, "canAskForRateUs":false, "userDefinedServerHost":"192.168.0.1", "userDefinedServerPort":4307, "language":"ru" } |
Значения некоторых параметров допустимо использовать только в паре с другими параметрами. Например, если параметру corporateServer
(отвечает за автоматическое подключение приложения к серверу при запуске) установить значение true
, то тогда обязательно нужно указать параметр userDefinedServerHost
с адресом сервера для подключения. Все параметры, которые необходимо использовать в паре, отмечены в указанном выше PDF-файле.
Запуск приложения
Разместите созданный файл settings.json
в директории с установленным приложением:
- Для Windows –
C:\Program Files\TrueConf\Client
- Для Linux –
/opt/trueconf/client/
- Для macOS –
/Applications/TrueConf\ Client.app/Contents/MacOS
(символ\
в данном пути необходим для экранирования пробела)
Название файла settings.json
при запуске подобным способом является обязательным. Настройки из файла с другим названием попросту не буду применены.
После этого запустите приложение. Все настройки применятся автоматически.
Запуск с явным указанием пути к файлу
Иногда может быть неудобно подменять файл по пути установки и требуется разово запустить приложение с предустановленными настройками. В этом случае можно использовать запуск с параметром --settings
. В качестве аргумента для этого параметра передайте полный путь к файлу настроек. Например из командной строки на Windows:
1 |
"C:\Program Files\TrueConf\Client\TrueConf.exe" --settings "D:/my_settings.json" |
Существует несколько способов запустить клиентское приложение TrueConf с параметрами командной строки. Все они подробно описаны в этой статье из нашей Базы знаний.
В отличии от способа из предыдущего подраздела, здесь вам не обязательно давать файлу настроек название settings
.