База знаний Автоматизация и API Планирование конференций

Запуск клиентского приложения TrueConf с параметрами командной строки

Димитрий Зуйков

23 августа, 2021

4 мин.

Клиентские приложения TrueConf для десктопных ОС (Windows, macOS, Linux) и программный ВКС-терминал TrueConf Room можно запускать с параметрами командной строки, благодаря чему пользователь может при открытии приложения автоматически:

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

Список параметров

В приложениях TrueConf для macOS и Linux при указании параметров с символом “\” его надо экранировать вторым символом “\”, например “/c \\c\\6427906610”.

Функция	Параметр и пример его использования
Авторизация	-l [user] -p [password] -e -lf `-l maria -p 4839 -e -lf` -l указывает логин для авторизации. Используется в сочетании с параметром —password, -p, который в свою очередь указывает пароль для авторизации. -e — обязательный параметр, указывающий на использование хеша от пароля вместо открытого вида. Используется совместно с —login, -l и —password, -p.
Подключение к серверу по его IP-адресу или доменному имени	-h [server]:[port] `-h 192.168.1.100:12345` `-h video.company.com`
Указание домена, по SRV-записям которого будет производиться поиск доступного ВКС-сервера для подключения	-d [domain_name] `-d company.com` Данный параметр рекомендуется использовать совместно с -h для корректной работы автологина в случае изменения адреса сервера в списке SRV-записей. Параметр -d работает следующим образом: все сервера из списка для параметра -h помечаются как сервера из этого домена; с помощью DNS SRV Discovery происходит запрос SRV-записей следующего вида: `vcs2.tcp.[domain name]`. После чего из полученного ответа от DNS-сервера выбирается один из доступных ВКС-серверов TrueConf. Но если Discovery ничего не находит, то берутся сервера из -h. После первого успешного подключения приложение TrueConf сохранит в своих настройках все адреса, которые указаны в списке Внешние адреса панели управления сервером. Конечно, вам для этого понадобится добавить новую SRV-запись в вашем домене.
Форсирование авторизации или подключения к серверу	-lf `-l maria -p 4839 -e -lf` Данный параметр можно использовать для принудительного подключения к указанному с параметром -h серверу, а также для авторизации с указанными логином и паролем. Если ключ -lf не указать и пользователь уже авторизован на сервере, то переподключения к нужному серверу или авторизации с новыми учётными данными не произойдёт.
Запуск приложения в различных режимах
Полноэкранный (без отображения элементов интерфейса)	-f Использование данного параметра будет уместным совместно с параметром -c при автоматическом совершении видеозвонков, если вам важно видеть только изображения собеседников по конференции без элементов интерфейса.
Свернутый	-m
Режим “копии”	-t [id] Использование данного параметра запустит копию приложения с указанным пользователем идентификатором. Настройки копии приложения сохраняются отдельно от настроек оригинала и не теряются после их закрытия и воспроизводятся автоматически при повторном запуске по тому же идентификатору. Это будет полезно, например, для подключения к другому серверу при использовании совместно с параметрами: -l (логин); -p (пароль); -h (указание к какому серверу подключиться).
Выбор монитора для вывода главного экрана TrueConf Room	-monitor [id] `-monitor 2` Применимо только для TrueConf Room. По умолчанию главный экран TrueConf Room запускается на мониторе, который используется в ОС в качестве основного, например, в ОС Windows он будет иметь индекс 1. С помощью ключа -monitor это поведение можно изменить, то есть при подключении дополнительного дисплея вы можете вывести на нём главный экран TrueConf Room, указав параметр -monitor 2. Это позволит вам использовать разные дисплеи для отображения окна конференции и одновременного управления программным терминалом, используя веб-панель.
Вызов пользователя или присоединение к конференции
Звонок пользователю	-c [user] `-c george` -c [user] @ [server_name] `-c george@company.com`
Подключение к конференции на сервере по \c\CID	-c \с\[CID] `-c \c\6427906610` -c \с\[CID]@[server_name]#vcs `-c \c\6427906610@company.com#vcs`
Автоматическое закрытие приложения после завершения звонка/конференции	-ac Данный параметр можно использовать только совместно с параметром -с. `-c kate -ac` `-c \c\5427905512 -ac`
Дополнительные параметры работы приложения
Изменение типа рендера	`-r [render-type]` или `--render [render-type]` `-r opengl или --render opengl` Указать типа рендера, который будет использоваться в приложении. Может быть полезно попробовать указать какое-то значение из списка ниже (перебором), если наблюдаются проблемы с отрисовкой приложения (так называемые “артефакты”). Если ничего не поможет, следует собрать логи и создать обращение в техподдержку Труконф. Доступны следующие типы рендера: gl opengl gles opengles directx angle soft soft-gl gdi
Запуск с параметрами из файла	—settings [file-path] `--settings "C:\Program Files\TrueConf\Client\settings.json"` Подробнее о запуске приложения с настройками из файла мы рассказали в соответствующей статье.

Здесь:

[user] — логин пользователя;
[password] — пароль пользователя
[server] — IP сервера TrueConf;
[server_name] — FQDN — имя сервера TrueConf;
[port] — порт, отведённый под панель управления сервера;
[id] — уникальный идентификатор копии приложения;
[CID] — ID конференции.

Параметры можно произвольным образом комбинировать. Например:

чтобы подключиться и авторизоваться на сервере TrueConf, выполните команду

TrueConf.exe -h 192.168.1.100:12345 -l maria -p 4839 -e

1

TrueConf.exe -h 192.168.1.100:12345 -l maria -p 4839 -e
чтобы пройти авторизацию и позвонить пользователю, выполните команду

TrueConf.exe -c george -l maria -p 4839 -e

1

TrueConf.exe -c george -l maria -p 4839 -e
чтобы пройти авторизацию и подключиться к конференции, выполните команду

TrueConf.exe -c \c\5427905512 -l maria -p 4839 -e

1

TrueConf.exe -c \c\5427905512 -l maria -p 4839 -e
чтобы запустить еще один экземпляр приложения и подключиться к серверу TrueConf по IP, выполните команду

TrueConf.exe -t 1 -h 192.168.1.100:12345 -lf

1

TrueConf.exe -t 1 -h 192.168.1.100:12345 -lf
чтобы запустить еще один экземпляр приложения TrueConf Room, подключиться к серверу TrueConf по его доменному имени и вывести главный экран на дополнительный монитор, выполните команду

TrueConfRoom.exe -t 1 -h video.company.com -lf -monitor 2

1

TrueConfRoom.exe -t 1 -h video.company.com -lf -monitor 2

Как использовать параметры при запуске

Способ 1. Запустить приложение через консоль

Перейдите в консоли ОС Windows к папке, где установлено клиентское приложение TrueConf, и выполните одну из команд, описанных в предыдущем разделе.

Запуск клиентского приложения TrueConf с параметрами командной строки 1

Способ 2. Встроить параметры в ярлык приложения

Найдите на рабочем столе или в панели задач ярлык клиентского приложения TrueConf
В контекстном меню ярлыка выберите вкладку Свойства.
Добавьте параметры запуска в поле Объект после кавычек, ограничивающих имя файла.

Запуск клиентского приложения TrueConf с параметрами командной строки 2

Нажмите ОК или Применить для сохранения изменений.

Способ 3. Добавить к программному запуску приложения

Вы можете встроить параметры в вызов клиентского приложения TrueConf из вашего собственного приложения чтобы автоматически соединять пользователей с нужными абонентами или конференциями. Ниже показан пример такого использования на языке Python:

import os

TRUECONF_PATH = "C:\\Program Files (x86)\\TrueConf\\Client\\TrueConf.exe"

PARAMETERS_ALIASES = {
    "login": "l",
    "password": "p",
    "encrypt": "e",
    "call": "c",
    "host": "h"
}

def run_trueconf(**kwargs):
    if "password" in kwargs:
        kwargs["encrypt"] = True
    
    params = []
    for alias, key in PARAMETERS_ALIASES.iteritems():
        if alias in kwargs:
            value = kwargs[alias]
            if value == True:
                params.append("-{}".format(key))
            elif value != False:
                params.append("-{} {}".format(key, value))
    
    command = " ".join(["\"{}\"".format(TRUECONF_PATH)] + params)
    return os.system(command)

run_trueconf(login = "ivan", password = "regereg")

import os

TRUECONF_PATH = "C:\\Program Files (x86)\\TrueConf\\Client\\TrueConf.exe"

PARAMETERS_ALIASES = {

"login": "l",

"password": "p",

"encrypt": "e",

"call": "c",

"host": "h"

}

def run_trueconf(**kwargs):

if "password" in kwargs:

kwargs["encrypt"] = True

params = []

for alias, key in PARAMETERS_ALIASES.iteritems():

if alias in kwargs:

value = kwargs[alias]

if value == True:

params.append("-{}".format(key))

elif value != False:

params.append("-{} {}".format(key, value))

command = " ".join(["\"{}\"".format(TRUECONF_PATH)] + params)

return os.system(command)

run_trueconf(login = "ivan", password = "regereg")

Предыдущая статья Следующая статья

Рубрики

Запуск клиентского приложения TrueConf с параметрами командной строки

Список параметров

Как использовать параметры при запуске

Способ 1. Запустить приложение через консоль

Способ 2. Встроить параметры в ярлык приложения

Способ 3. Добавить к программному запуску приложения

Попробуйте безопасную ВКС-платформу Труконф!

Крупнейшее ВКС-сообщество в России

Актуальные новости из мира ВКС