# Параметры командной строки
# Условные обозначения синтаксиса командной строки
В таблице ниже описана нотация, используемая для указания синтаксиса командной строки.
Нотация | Описание |
---|---|
Текст без квадратных, фигурных скобок или круглых скобок | Элементы, которые необходимо вводить так, как они отображаются. |
[Текст внутри квадратных скобок] | Необязательный аргумент. |
{Текст внутри фигурных скобок} | Обязательный аргумент. |
... | Неограниченное количество параметров в аргументе. |
# Описание стиля командной строки
- Разрешен
-
в коротких параметрах - Разрешен стиль
-<single character>
- Разрешен аргумент в том же токене для коротких параметров. Например:
-lsome
- Разрешен аргумент в следующем токене для коротких параметров. Например:
-l some
- Разрешен стиль
--long_name
- Разрешен аргумент в том же токене для длинных параметров. Например:
--login=ivanov
- Разрешен аргумент в следующем токене для длинных параметров. Например:
--login ivanov
- Разрешено объединение нескольких коротких параметров вместе, чтобы
-v -f
превратился в-vf
. Все параметры, кроме последнего, не должны принимать никаких аргументов. Например, если-v
принимает параметр, то в качестве параметра будет приниматьсяf
, а не другой короткий параметр - Разрешено сокращенное написание длинных параметров, если они однозначно идентифицируют длинный параметр. Никакое длинное имя параметра не должно быть префиксом другого длинного имени параметра, если действует угадывание
# Описание параметров командной строки
# --allowhidcontrol
Включить или отключить функционал работы с HID-устройствами. Значение параметра запоминается и будет использовано при следующих запусках.
Синтаксис:
--allowhidcontrol {true|false}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --allowhidcontrol false
# --autoclose
Возвращает TrueConf Room в исходное состояние после звонка.
Синтаксис:
--autoclose
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --autoclose
# --background
Указать путь до файла, который будет использоваться для виртуального фона.
Синтаксис:
--background {path_to_file}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --background c:\path\to\file.png
# --blur
Включить функционал размытия фона.
Синтаксис:
--blur
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --blur
# --br
Установить максимальный битрейт.
Правила:
- Аргумент должен быть положительном числом
Синтаксис:
--br {max_bitrate}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --br 28000
# --ccl, -x
Указать закодированную командную строку.
Параметр раскодируется и полученная строка используется, как обычные параметры.
Синтаксис:
--ccl {coded_cl}
-x {coded_cl}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --ccl L2WQ4gd5ml9jb25mL39yZy51YSAvcyAwMWUy
# --cid, -c
Позвонить после запуска TrueConf Room на указанный CallID.
CallID может быть как TrueConf ID пользователя, так и ID конференции (то есть, начинаться с \c\
).
Синтаксис:
--cid {CallID}
-c {CallID}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --cid \c\test@some.trueconf.com#vcs
# --crop
Включить Image cropper в указанном режиме при старте приложения. Доступные режимы (CropMode):
240p
360p
480p
720p
1080p
2160p
По умолчанию будет использоваться режим 720p
.
Синтаксис:
--crop {CropMode}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --crop 240p
# --domain, -d
Указать домен, с которым будет работать TrueConf Room.
Данный параметр используется в паре с --mh, -h.
Синтаксис:
--domain {some_domain}
-d {some_domain}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --domain server.org.ru --mh "se1.server.org.ru#as\se1.server.org.ru:4307,12.34.56.78:443,se1.trueconf.net:4307,se2.server.org.ru#as\se2.server.org.ru:4307,se2.server.org.ru:443"
# --dsrecord
Использовать directSoundRecord.
Доступно только в Windows
.
Синтаксис:
--dsrecord
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --dsrecord
# --encrypt, -e
Параметр, указывающий на то, нужно ли использовать хеш от пароля вместо открытого вида.
Используется совместно с --login
, -l
и --password
, -p
.
Синтаксис:
--encrypt
-e
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --password pass1234 --login ivanov --encrypt
# --filepath
Указание файла, в котором содержится ключ для TrueConf Room, либо файл, куда необходимо записать сгенерированный HID
для активации. См. также раздел Активация.
Синтаксис:
--filepath {path_to_file}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --filepath с:\regoffline2.rrg
# --hardware-key
Сгенерировать регистрационный файл, по которому можно будет получить лицензию на TrueConf Room (используется для оффлайн регистрации). См. также раздел Активация
Используется совместно с --filepath
и --license-key
.
Регистрационный файл regoffline.rrg
будет помещен в тот же каталог, где находится файл с лицензией, указанный в параметре --filepath
.
Синтаксис:
--hardware-key
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --hardware-key --license-key --filepath c:\file_with_key.txt
# --httpport
Указать порт для http-серверов.
Правила:
- Аргумент должен быть больше нуля и меньше 65536
Синтаксис:
--httpport {port}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --httpport 568
# --hwtest
Запустить тестирование оборудования.
TrueConf Room не будет запущен.
В результате будет записан файл tc_configuration.txt
с соответствующей информацией по пути:
на Windows
C:\Users\[user_name]\AppData\Local\TrueConf\Room
на Linux
/home/[user_name]/.config/trueconf/room/
где [user_name]
— логин пользователя в ОС.
Правила:
- Аргумент необязателен
- Аргумент в следующем токене для параметра не разрешен
- При отсутствии аргумента подставляется строка
tc_configuration.txt
Синтаксис:
--hwtest=[configuration.txt]
--hwtest
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --hwtest
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --hwtest=new_configuration.txt
# --ignore_monitor
Установить игнорируемые мониторы.
Правила:
- Аргумент представляет собой список игнорируемых мониторов. Разделяющий символ -
,
- В аргументе может быть:
- Номер монитора
- VID монитора
- PID монитора
- Совмещенный PID и VID монитора
- ID монитора
Синтаксис:
--ignore_monitor {monitor_index(,)pid(,)vid}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --ignore_monitor 1
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --ignore_monitor 1,vid_046d&pid_0867,vid_046d,pid_0823
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --ignore_monitor 1,vid_046d&pid_0867,vid_046d,pid_0823,display\\lgd0457\\4&1e135148&0&uid589652
# --license-key
Указать файл лицензии для TrueConf Room. Используется совместно с --filepath
. См. также раздел Активация
Для оффлайн активации используется совместно с --hardware-key
.
Синтаксис:
--license-key
Пример:
// Онлайн активация
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --license-key --filepath c:\file_with_key.txt
// Офлайн активация - генерация файла для регистрации. В заданном файле должен находиться серийный номер для активизации программы.
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --hardware-key --license-key --filepath c:\file_with_key.txt
// Офлайн активация - задание файла с лицензией. В заданном файле должна находиться лицензия для активизации программы.
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --license-key --filepath c:\regoffline2.rrg
# --log
Включить логирование в файлы.
В аргументе указываются модули, которые необходимо логировать.
При указании переопределяет значение из БД для текущего запуска TrueConf Room. В БД значение не сохраняется.
Взаимоисключающий с параметром --nolog
, будет отработан параметр, который встретится раньше.
Правила:
- Аргумент необязателен
- Аргумент в следующем токене для параметра не разрешен
- Аргумент является числом (в десятичной, в двоичной или шестнадцатеричной форме)
Синтаксис:
--log=[modules]
--log
# --logapi
Включить логирование выполнения методов API.
При отсутствии параметра функционал выключен. Если включен, будет логироваться каждый запрос на выполнение команды, а также результат выполнения. Кроме команд в логи будет занесена еще и информация о возникших нотификациях. Приватная информация будет заменена на хеш от нее.
Синтаксис:
--logapi
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --logapi
# --login, -l
Указать логин для авторизации.
Используется в сочетании с параметром --password
, -p
.
Если пароль передаётся в незашифрованном виде, необходимо указывать параметр --encrypt
, -e
.
Синтаксис:
--login {some_login}
-l {some_login}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --login ivanov --password pass1234 -e
# --loginforce
Параметр, обозначающий перелогин.
Используется совместно с --login
, -l
и --password
, -p
.
Синтаксис:
--loginforce
# --master
Указать идентификатор канала для обмена сообщениями в первичным TrueConf Room в функционале дополнительного видеопотока.
Синтаксис:
--master {channelName}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --master abcd123
# --mfa
Параметр для указания параметров исходящего аудиопотока.
Правила:
- Список аргументов состоит из 2 параметров. Их регистр не учитывается:
sr
- частота дискретизацииenc
- Название кодека. Доступны следующие типы:pcm
g711a
g711mu
g722
g723
g728
g729a
g722.1/24
g722.1/32
g722.1c/24
g722.1c/32
g722.1c/48
speex
isac
opus
aac
mp3
- Каждый параметр является опциональным.
- Параметры между собой необходимо разделять с помощью
|
. - Значение параметра необходимо отделять с помощью
:
-key:value
. - Аргумент необходимо писать в кавычках или экранировать разделяющие символы для корректного распознавания команды.
Синтаксис:
--mfa {(")enc(:)enc_name(|)sr(:)samplerate(")}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --mfa enc:g722.1c/24|sr:48000
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --mfa enc:g722.1c/24
# --mfv
Параметр для указания параметров исходящего видеопотока.
Правила:
- Список аргументов состоит из 3 параметров. Их регистр не учитывается:
res
- Разрешение видео. Значение аргумента - ширина и высота. Разделяющий символ -x
enc
- Название кодека. Доступны следующие типы:h265
h264
h263p
h263
h261
vp8
vp9
vp8stereo
fr
- частота кадров
- Каждый параметр является опциональным.
- Параметры между собой необходимо разделять с помощью
|
. - Значение параметра необходимо отделять с помощью
:
-key:value
. - Аргумент необходимо писать в кавычках или экранировать разделяющие символы для корректного распознавания команды.
Синтаксис:
--mfv {(")res(:)width(x)height(|)enc(:)enc_name(|)fr(:)framerate(")}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --mfv res:1980x1080|enc:h264|fr:30
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --mfv enc:h264|fr:15
# --mh, -h
Указать список серверов, с которым будет работать TrueConf Room.
Синтаксис:
--mh {server_name1(,)server_name2(,)...}
-h {server_name1(,)server_name2(,)...}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe -h some.trueconf.com,127.0.0.1
# --min, -m
Запустить TrueConf Room со свёрнутым (минимизированным) главным окном. Если этот ключ используется при запуске вторичного TrueConf Room в функционале дополнительного видеопотока, его окно будет постоянно скрыто.
Синтаксис:
--min
-m
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --min
# --monitor
Установить монитор, на котором будет отображен TrueConf Room.
Если был передан UUID монитора, TrueConf Room будет привязан к этому монитору, игнорируя сохраненное с предыдущей сессии значение.
Взаимоисключающий с параметром --position
, будет отработан параметр, который встретится первее.
Правила:
- Аргумент должен быть номером монитора или UUID монитора
Синтаксис:
--monitor {monitor_index_or_device_instance_path}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --monitor 1
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --monitor DISPLAY\AUO24ED\4&1b4e36bd&8&UID265988
# --ndi
Включить протокол NDI на прием и отправку.
Синтаксис:
--ndi
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --ndi
# --nofsbrdr
Выключить рамку окна шириной в один пиксель.
Доступно только в Windows
.
Синтаксис:
--nofsbrdr
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --nofsbrdr
# --nolog
Отключить логирование в файлы.
Взаимоисключающий с параметром --log
, будет отработан параметр, который встретится раньше.
Синтаксис:
--nolog
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --nolog
# --noptz
Отключить возможность управлять поворотом, наклоном и зумом ptz-камер.
Синтаксис:
--noptz
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --noptz
# --nosplash
Запустить TrueConf Room без сплаш-окна.
Синтаксис:
--nosplash
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --nosplash
# --no_mdns
Отключить механизм автоматического обнаружения запущенных экземпляров TrueConf Room в локальной сети.
Синтаксис:
--no_mdns
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --no_mdns
# --offhwdec
Отключить хардварное декодирование.
Синтаксис:
--offhwdec
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --offhwdec
# --offhwenc
Отключить хардварное кодирование.
Синтаксис:
--offhwenc
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --offhwenc
# --password, -p
Указать пароль для авторизации.
Используется в сочетании с параметром --login
, -l
.
Если пароль передаётся в незашифрованном виде, необходимо указывать параметр --encrypt
, -e
.
Синтаксис:
--password {some_password}
-p {some_password}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --password pass1234 --login ivanov -e
# --pin
Aвторизоваться в web-интерфейсе по указанному пину.
Синтаксис:
--pin {some_pin}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --pin d5f6g8
# --position
Задать размер и положение главного окна при старте.
Взаимоисключающий с параметром --monitor
. Будет отработан параметр, который встретится первее.
Правила:
- Аргумент в качестве значения содержит x-координату, y-координату, ширину и высоту. Разделяющий символ -
,
Синтаксис:
--position {x,y,w,h}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --position 100,100,600,600
Можно вывести окно TrueConf Room на дополнительный монитор, т.к. координатная сетка общая для всех подключенных дисплеев. Узнать начало отсчёта координат для нужного монитора можно одним из двух способов.
Способ 1. Запустите приложение TrueConf Room и выполните команду getMonitorsInfo. Запомните начало отсчёта координат для нужного дисплея (параметр geomMonitor
), закройте TrueConf Room и запустите его снова с параметром --position
.
Способ 2. Через команды ОС.
Для Windows: выполните в PowerShell код
Add-Type -AssemblyName System.Windows.Forms
>> [System.Windows.Forms.Screen]::AllScreens
В ответе будет содержаться список мониторов и начало отсчёта координат для каждого из них в параметре Bounds
. Например, вывод:
BitsPerPixel : 32
Bounds : {X=0,Y=0,Width=1920,Height=1080}
DeviceName : \\.\DISPLAY1
Primary : True
WorkingArea : {X=0,Y=0,Width=1920,Height=1040}
BitsPerPixel : 32
Bounds : {X=0,Y=0,Width=1920,Height=1080}
DeviceName : \\.\DISPLAY2
Primary : True
WorkingArea : {X=0,Y=-1080,Width=1920,Height=1040}
означает, что для монитора с индексом 2
отсчёт координат начинается с точки 0, -1080
. Чтобы вывести на него окно TrueConf Room со сдвигом по вертикали на 100 пикселей, укажите параметр --position 0,-980,1920,980
.
Для Linux: выполните в терминале команду
xrandr --listmonitors
В ответе будет содержаться список мониторов и начало отсчёта координат для каждого из них через знак +
после размеров. Например, вывод:
Monitors: 2
0: +*eDP 1920/344x1080/194+0+1080 eDP
1: +HDMI-A-0 1920/477x1080/268+0+0 HDMI-A-0
означает, что подключено 2 дисплея и у первого из них координаты отсчитываются от точки 0, 1080
. Чтобы вывести на него окно TrueConf Room со сдвигом по вертикали на 100 пикселей, укажите параметр --position 0,1180,1920,980
.
# --quit -q
Завершить запущенный экземпляр TrueConf Room.
Синтаксис:
--quit
-q
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --quit
# --rectonview
Установить координаты прямоугольника, в котором будет отображен TrueConf Room.
Правила:
- Аргумент представляет собой список 5 параметров прямоугольника. Разделяющий символ -
,
- В аргументе должны быть:
- Число, которое является позицией по x
- Число, которое является позицией по y
- Число, которое является высотой
- Число, которое является шириной
- Число, которое задаёт прозрачность, в пределах от 0 до 255
Синтаксис:
--rectonview {x,y,width,height,alpha}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --rectonview 120,60,100,500,155
# --render, -r
Указать типа рендера, который будет использоваться в TrueConf Room.
Правила:
- Доступны следующие типы рендера:
gl
opengl
gles
,opengles
directx
angle
soft
soft-gl
gdi
Синтаксис:
--render {type_render}
-r {type_render}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --render gdi
# --reset-settings
Сбросить настройки продукта. Список возможных имен точно такой же, как и в методе getSettings. Помимо этих значений также доступно webauth
, который обозначает сброс авторизационных данных для страницы управления (т.е. сброс тех вещей, которые задаются методами setAuthParams для auth)
Правила:
- В качестве аргумента передаётся список настроек
- Разделяющий символ -
,
Синтаксис:
--reset-settings {some_setting1(,)some_setting2(,)...}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --reset-settings language,webauth
# --settings
Применяет новые настройки из файла json
, указанного в аргументе.
Синтаксис:
--settings {path_to_json}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --settings c:\settings.json
# --slave
Указать идентификатор канала для обмена сообщениями во вторичным TrueConf Room в функционале дополнительного видеопотока. Должен быть такой же, как и переданный в --master
ключе
Синтаксис:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --slave abcd123
# --sysrescheck
Включить проверку системных ресурсов.
Синтаксис:
--sysrescheck
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --sysrescheck
# --templogin
Параметр, обозначающий автологин.
Используется совместно с --login
, -l
и --password
, -p
.
Синтаксис:
--templogin
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --templogin
# --twin, -t
Запустить ещё один экземпляр TrueConf Room с заданным наименованием.
По умолчанию TrueConf Room при старте проверяет наличие запущенного экземпляра TrueConf Room и, если находит, отправляет ему параметры, с которыми был запущен, затем завершает работу.
Все экземпляры не влияют на работу друг друга, а настройки хранятся в папке с именем твина, заданного в параметрах.
Правила:
Аргумент необязателен
Аргумент в следующем токене для параметра не разрешен
При отсутствии аргумента подставляется строка
twin
Максимальная длина имени - 32 символа
Разрешенные символы:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_-.
Неразрешенные символы заменяются на
_
Синтаксис:
--twin=[twin_name]
-t [twin_name]
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --twin=user1
C:\Program Files\TrueConf\Room>TrueConfRoom.exe -t user2
C:\Program Files\TrueConf\Room>TrueConfRoom.exe -t
# --url, -u
Указать ссылку для загрузки параметров, с которыми необходимо запустить TrueConf Room.
При использовании этого параметра другие параметры игнорируются.
Новая командная строка приходит в ответе на запрос, время ожидания ответа - 2-5 секунд.
При отсутствии ответа запускается TrueConf Room без параметров. В новых параметрах игнорируются параметры --ccl
, -x
и --url
, -u
.
Синтаксис:
--url {download_URL}
-u {download_URL}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe -u https://some.server.com/cnf/0c014232
# --verbose, -v
Разрешить вывод логов в консоль.
Синтаксис:
--verbose
-v
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe -v
# --wsport
Указать порт для web-сокетов.
Правила:
- Аргумент должен быть больше нуля и меньше 65536
Синтаксис:
--wsport {port}
Пример:
C:\Program Files\TrueConf\Room>TrueConfRoom.exe --wsport 568
См. также: