Вернуться

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

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

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

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

В приложениях TrueConf для macOS и Linux при указании параметров с символом “\” его надо экранировать вторым символом “\”, например “/c \\c\\6427906610”.
Функция Параметр и пример его использования
Авторизация -l [user] -p [password] -e -lf

-l maria -p 4839 -e -lf

Подключение к серверу по его IP-адресу или доменному имени -h [server]:[port]

-h 192.168.1.100:12345

-h video.company.com

Вы можете указать через запятую несколько IP-адресов или доменных имён (FQDN) TrueConf Server, тогда приложение подключится к первому доступному из них. Например: -h 192.168.1.100,192.168.1.101.
Форсирование авторизации или подключения к серверу -lf

-l maria -p 4839 -e -lf

Данный параметр можно использовать для принудительного подключения к указанному с параметром -h серверу, а также для авторизации с указанными логином и паролем. Если ключ -lf не указать и пользователь уже авторизован на сервере, то переподключения к нужному серверу или авторизации с новыми учётными данными не произойдёт.
Указание домена, по SRV-записям которого будет производиться поиск доступного ВКС-сервера для подключения -d [domain_name]

-d company.com

Если указать данный параметр, то клиентское приложение при первом запуске подключится не к сервису TrueConf Online (поведение по умолчанию), а выполнит запрос SRV-записей следующего вида: vcs2.tcp.[domain name]. После чего из полученного ответа от DNS-сервера выберет один из доступных ВКС-серверов TrueConf.

После первого успешного подключения приложение TrueConf сохранит в своих настройках все адреса, которые указаны в списке Внешние адреса панели управления сервером.

Это будет полезно для автоматизации подключения приложения к нужному серверу при его первом запуске, если у вас одному ВКС-серверу соответствует несколько внешних IP-адресов или вы используете решение TrueConf Enterprise. Вы можете обратиться к нам, чтобы мы собрали для вас установщик с уже заданным значением домена по умолчанию.

Запуск приложения в различных режимах
Полноэкранный (без отображения элементов интерфейса) -f

Использование данного параметра будет уместным совместно с параметром -c при автоматическом совершении видеозвонков, если вам важно видеть только изображения собеседников по конференции без элементов интерфейса.
Свернутый -m
Режим “копии” -t [id]

Использование данного параметра запустит копию приложения с указанным пользователем идентификатором. Настройки копии приложения сохраняются отдельно от настроек оригинала и не теряются после их закрытия и воспроизводятся автоматически при повторном запуске по тому же идентификатору.
Выбор монитора для вывода главного экрана 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 [email protected]

Подключение к конференции на сервере по \c\CID -c \с\[CID]

-c \c\6427906610

-c \с\[CID]@ [server_name]

-c \c\[email protected]

Автоматическое закрытие приложения после завершения звонка/конференции -ac

Данный параметр можно использовать только совместно с параметром .

-c kate -ac

-c \c\5427905512 -ac

Здесь:

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

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

  • чтобы подключиться и авторизоваться на сервере TrueConf, выполните команду
  • чтобы пройти авторизацию и позвонить пользователю, выполните команду
  • чтобы пройти авторизацию и подключиться к конференции, выполните команду
  • чтобы запустить еще один экземпляр приложения и подключиться к серверу TrueConf по IP, выполните команду
  • чтобы запустить еще один экземпляр приложения TrueConf Room, подключиться к серверу TrueConf по его доменному имени и вывести главный экран на дополнительный монитор, выполните команду

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

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

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

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

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

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

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

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

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

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

Ниже показан пример такого использования на языке Python:


Не нашли ответ на свой вопрос? Напишите нам в онлайн-чате, мы будем рады помочь.

Подписка на новости