# Managing the Endpoint from the Command Line Interface
Терминал TrueConf Group предоставляет возможность управления не только с пульта и через веб-интерфейс, но и с помощью интерфейса командной строки (Command Line Interface, CLI). Для этого используется подключение по SSH из любого имеющегося у вас приложения, например, PuTTY или OpenSSH.
Данная возможность также позволяет легко интегрировать TrueConf Group в системы управления переговорными комнатами, и вывести в интерфейс планшета кнопки для контроля терминала.
# Как подключиться
Шаг 1. Чтобы подключиться к терминалу из командной строки, сначала требуется установить пароль доступа:

В панели управления перейдите в раздел Configuration → Maintenance.
Укажите пароль для доступа к терминалу по SSH в поле Password секции API password.
Нажмите Apply для сохранения пароля на устройстве. В целях безопасности он скрывается, но вы всегда сможете его посмотреть с помощью кнопки
.
Шаг 2. Теперь вам требуется подключиться из SSH-клиента. Используется логин admin
:
- Установите (если ранее этого не сделали) и запустите клиент SSH, например, из пакета OpenSSH или любой другой. Во многих операционных системах он уже присутствует, например, в Windows 10 и новее достаточно просто выполнить команду:
ssh admin@[group_ip]
где [group_ip]
— IP-адрес вашего терминала.
2. Укажите созданный на шаге 1 пароль.
3. Появится приветственный текст CLI TrueConf Group. Теперь вы можете ввести любые поддерживаемые команды:
user@debian:~$ ssh admin@10.160.2.55
admin@10.160.2.55's password:
Welcome to TrueConf Group Management Shell 1.1.0.470
(tcg cli)
Команды являются регистронезависимыми, но все буквы должны быть в одном регистре. Например, можно ввести как команду HELP
так и help
, но не Help
.
Чтобы вывести список команд, используйте команду HELP
.
Для вывода информации о конкретной команде [command]
введите [command] HELP
.
Параметры указываются (в случае их наличия) просто через пробел после команды, например, команда
CALLHISTORY 10
выведет 10 последних записей из журнала вызовов.
# Commands
# ANSWER
Принять входящий вызов.
Параметр | Описание |
---|---|
VIDEO | Принять входящий вызов, если для него выключен автоприём. Это можно проверить в панели управления в разделе Configuration → Call → Auto answer options. |
# AUDIOCODEC
Разрешить или запретить использование аудиокодека.
Параметр | Описание |
---|---|
[CODEC] ON | Разрешить использовать аудиокодек [CODEC] |
[CODEC] OFF | Запретить использовать аудиокодек [CODEC] |
[CODEC] GET | Получить текущее состояние кодека [CODEC] |
GET | Получить текущее состояние всех аудиокодеков |
Learn more about all codecs supported by the endpoint in the Supported protocols and codecs section.
# AUDIOMUTE
Управление микрофоном.
Параметр | Описание |
---|---|
ON | Отключить микрофон |
OFF | Включить микрофон |
GET | Получить текущее состояние микрофона |
REGISTER | Получать уведомления об изменении состояния микрофона. Если оператор терминала будет включать/выключать микрофон, то в консоли будут выводиться соответствующие уведомления. Данные сообщения будут поступать до их отключения с помощью команды UNREGISTER и только в текущем сеансе подключения по SSH. |
UNREGISTER | Отключить уведомления об изменении состояния микрофона |
# AUTOANSWER
Настройка автоматического приёма вызовов.
Параметр | Описание |
---|---|
YES | Автоматический приём первого входящего вызова. Аналогично выставлению значения Auto answer у параметра Settings → Call → Auto answer options → Answer first call |
NO | Отключение автоответа на входящий вызов. Аналогично выставлению значения Manual у параметра Settings → Call → Auto answer options → Answer first call |
DND | Запрет входящих вызовов, все они будут автоматически сбрасываться. Аналогично выставлению значения Do not disturb в пункте Settings → Calls → Auto answer options → Answer first call |
GET | Получить текущее значение параметра автоприёма вызова |
# CALLINFO
Viewing Call Information
Команда выводит техническую информацию об одном или нескольких (в случае использования функции MCU) активных подключениях. Параметр CallID
нужен для идентификации вызова и используется в других командах. Пример работы команды:
TCG console>CALLINFO
Active calls:
CallID:"8"
Direction:Outgoing
Contact URI:"sip:admin@demoi.trueconf.com"
User agent:"TrueConf Server 5.0.0.1586"
Duration:230 sec
Bitrate:"1008"
Audio in: Compression:"G.722.1C (32 kbit/s)", Bitrate:"32", Packets:"11304", Lost packets:"0", Loss rate:"0"%, Jitter:"30"
Audio out: Compression:"G.722.1C (48 kbit/s)", Bitrate:"48", Packets:"11301", Lost packets:"0", Loss rate:"0"%, Jitter:"10"
Video in: Codec:"H264", Bitrate:"960", Resolution:"1280x720", Frame rate:"27", Packets:"35495", Lost packets:"0", Lossrate:"0%", Jitter:"11%"
Video out: Codec:"H264", Bitrate:"960", Resolution:"1280x720", Frame rate:"30", Packets:"39959", Lost packets:"0", Lossrate:"0%", Jitter:"2%
# CALLHISTORY
Call History
Параметр | Описание |
---|---|
N | Количество последних вызовов для вывода, по умолчанию N=5 |
# CAMERA
PTZ Camera Control
Параметр | Описание |
---|---|
LEFT, RIGTH, UP, DOWN | Повернуть камеру соответсвенно влево, вправо, вверх, вниз |
ZOOM+, ZOOM- | Приблизить или отдалить изображение |
STOP | Остановить перемещение камеры |
Проверить правильность настроек камеры можно в панели управления терминалом в разделе Settings → Video → Capture.
# CAMERAMUTE
Управление передачей изображения с камеры.
Параметр | Описание |
---|---|
ON | Отключить видеопоток от камеры |
OFF | Включить видеопоток от камеры |
GET | Получить текущее состояние камеры |
REGISTER | Подписаться на получение уведомлений на отключение/включение камеры: в консоль будут выводиться соответствующие уведомления. Данные сообщения будут поступать до их отключения с помощью команды UNREGISTER и только в текущем сеансе подключения по SSH. |
UNREGISTER | Отключить уведомления об изменении состояния камеры |
# CONTENT
You can share content in the Conference control section of the control panel.
Параметр | Описание |
---|---|
PREVIEW | Включить предварительный просмотр контента, не отправляя его в конференцию |
SHARE | Начать трансляцию контента в конференцию |
STOP | Остановить трансляцию контента |
# CORETEMP
Получить температуру процессора терминала.
Пример вызова команды и ответа:
(tcg cli) CORETEMP
CPU temperature: +50.0°C
# DIAL
Вызов абонента.
Параметр | Описание |
---|---|
URI | Осуществить исходящий вызов по заданному URI |
Depending on the usage scenario:
# DTMF
Отправить DTMF код CODE
абоненту с ID [CallID]. Код состоит из цифр и обычно заканчивается символом #
.
Параметр | Описание |
---|---|
[CallID] | Осуществить исходящий вызов по заданному URI |
URI | Осуществить исходящий вызов по заданному URI |
После отправки будет выведено соответствующее сообщение, наример, отправка кода 111#
абоненту с ID 272
:
(tcg cli) DTMF 272 111#
DTMF code passed successfully
# HANGUP
Завершить вызов.
Параметр | Описание |
---|---|
VIDEO [CallID] | Завершить подключение с ID [CallID] . Значение идентификатора вызова [CallID] выводится при установлении соединения, например, как показано в примере уведомления Outgoing call |
ALL | Завершить все текущие подключения |
Пример работы команды:
TCG console>hangup video 266
Hangup the video call [266] passed
TCG console>
Hangup call [266]:
Name:"Room"
Contact URI:"h323:room@video.company.com:1720"
Protocol:"H.323"
# HOSTNAME
Получить или установить имя системы.
Параметр | Описание |
---|---|
SET [NAME] | Установить имя системы. После этого будет выведено соответствующее сообщение. |
GET | Вывести имя системы |
Пример получения названия и задания нового:
(tcg cli) hostname get
System hostname:"TrueConf Group"
(tcg cli) hostname set New name
Hostname "New name" set successfully
# IP
Получить IP-адрес TrueConf Group.
Параметр | Описание |
---|---|
ADDRESS | Вывести IP-адрес TrueConf Group |
ROUTE | Вывести таблицу маршрутизации |
Пример работы команды IP ADDRESS
:
(tcg cli) ip address
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
link/ether fc:34:97:67:62:5f brd ff:ff:ff:ff:ff:ff
inet 10.160.2.55/22 brd 10.160.3.255 scope global noprefixroute dynamic eth0
valid_lft 22589sec preferred_lft 22589sec
inet6 fe80::d2c4:ad3a:e4f8:b569/64 scope link noprefixroute
valid_lft forever preferred_lft forever
Пример работы команды IP ROUTE
:
(tcg cli) ip route
default via 10.160.0.1 dev eth0 proto dhcp metric 100
10.160.0.0/22 dev eth0 proto kernel scope link src 10.160.2.55 metric 100
# LAYOUT
Управление раскладкой в групповой конференции при использовании функции MCU или в звонке точка-точка если отображается селфвью (то есть в раскладке 2 видеоокна). Подробнее о раскладках смотрите в разделе работы с терминалом.
Параметр | Описание |
---|---|
EQUAL | Установить раскладку с одинаковым размером видеоокон |
TOP | Установить раскладку с приоритетным окном сверху |
BOTTOM | Установить раскладку с приоритетным окном снизу |
LEFT | Установить раскладку с приоритетным окном слева |
RIGHT | Установить раскладку с приоритетным окном справа |
AUTO | Установить автоматическую раскладку |
GET | Получить текущий тип раскладки |
# LISTDEVICE
Получить список доступных аудио и видео устройств, подключенных к терминалу.
Параметр | Описание |
---|---|
Без параметра | Вывести информацию обо всех аудио/видео устройствах |
AUDIO | Получить список всех аудиоустройств, подключенных к терминалу |
AUDIO CAPTURE | Получить список всех устройств захвата звука, подключенных к терминалу |
AUDIO RENDER | Получить список всех устройств воспроизведения аудио, подключенных к терминалу |
VIDEO | Получить список всех видеоустройств, подключенных к терминалу |
VIDEO CAPTURE | Получить список всех устройств захвата изображения, подключенных к терминалу |
VIDEO RENDER | Получить список всех устройств вывода изображения (дисплеев), подключенных к терминалу |
SERIAL | Получить список подключенных последовательных портов. Может быть использована для идентификации подключенных внешних адаптеров USB-RS232 |
При использовании любой из команд у каждого устройства выводится его идентификатор в параметре id
— он используется при выполнении других команд работы с оборудованием, например, для выбора устройства SETDEVICE
.
Пример получения списка всех аудио и видео устройств:
(tcg cli) listdevice
Available audio capture devices:
id="1", "Line in", active:False, default:False, level:100%, boost:0, aec:0, agc:False, noise suppressor:False
id="2", "HDMI1", active:False, default:False, level:100%, boost:0, aec:0, agc:False, noise suppressor:False
id="3", "HDMI2", active:False, default:False, level:100%, boost:0, aec:0, agc:False, noise suppressor:False
id="4", "eMeet M2 [USB Audio]", active:True, default:False, level:100%, boost:0, aec:0, agc:False, noise suppressor:False
Available audio render devices:
id="1": "Display port", active:False, default:False, level:86%
id="2": "HDMI", active:False, default:False, level:52%
id="3": "Line out", active:False, default:False, level:17%
id="4": "eMeet M2 [USB Audio]", active:True, default:False, level:4%
id="5": "All outputs", active:False, default:False, level:50%
Available video capture devices:
id="1": "Clevermic 1212U/HD Camera", video:1280x720@60.01
id="2": "HDMI1/MZ0380:RAW 00.00 12abf55f", video:1920x1080@0.0
id="3": "HDMI2/MZ0380:RAW 01.00 12abf55f", video:1920x1080@0.0
id="4": "USB/file", video:1920x1080@25.0
Available video render devices:
id="1": "BenQ GL2460", port: HDMI", active:True
# MULTIPOINT
Управление функцией MCU.
Параметр | Описание |
---|---|
ON | Активация функции MCU |
OFF | Отключение функции MCU |
GET | Вывести текущий статус функции MCU |
# PROTOCOL
Управление использованием протоколов SIP и H.323.
Параметр | Описание |
---|---|
PROTOCOL SIP [ON/OFF] | Включение/отключение работы по протоколу SIP |
PROTOCOL H323 [ON/OFF] | Включение/отключение работы по протоколу H.323 |
PROTOCOL SIP SRTP [ON/OFF/MANDATORY] | Управление использованием SRTP кодирования при звонках по протоколу SIP: ON — использование кодирования предпочтительно, но необязательно; OFF — не используется; MANDATORY — терминал не будет соединяться с абонентами, у которых отсутсвует поддержка SRTP |
PROTOCOL H323 H235 [ON/OFF/MANDATORY] | Управление использованием H.235 кодирования при звонках по протоколу H.323: ON — использование кодирования предпочтительно, но необязательно; OFF — не используется; MANDATORY — терминал не будет соединяться с абонентами, у которых отсутсвует поддержка H.235 |
PROTOCOL SIP GET | Вывести текущий статус использования протокола SIP |
PROTOCOL H323 GET | Вывести текущий статус использования протокола H.323 |
PROTOCOL SIP SRTP GET | Вывести текущий статус использования SRTP кодирования при звонках по протоколу SIP |
PROTOCOL H323 H235 GET | Вывести текущий статус использования H.235 кодирования при звонках по протоколу H.323 |
Одновременно отключить оба протокола SIP и H.323 нельзя. Если один из них деактивирован и происходит попытка отключения второго, то первый автоматически активируется.
# REBOOT
Выполнить перезагрузку TrueConf Group.
Команда аналогична нажатию кнопки Restart в разделе Settings → Power supply → Power control панели управления терминалом.
Данная команда выполняется сразу после её отправки, без предварительного запроса подтверждения (в отличие от аналогичного действия в панели управления).
# RCKEY
Послать код кнопки пульта ДУ для выполнения соответствующей команды как будто она была нажата физически.
Параметр | Описание |
---|---|
KEY | Код кнопки пульта. Допустимые значения: 0..9 , * , # , HOME , BACK , MENU , OK , LEFT , RIGHT , UP , DOWN , DIAL , BACKSPACE , HANGUP , PC , FARNEAR , LAYOUT , ZOOM+ , ZOOM- , VOL+ , VOL- , POWER |
Пример команды для приближения изображение с подключенной к терминалу PTZ-камеры:
(tcg cli) rckey zoom-
RCKEY passed successfully
# SELFVIEW
Установить режим отображения собственного локального видео (селфвью) на экране терминала (не влияет на его отображение в раскладке).
Параметр | Описание |
---|---|
ON | Отображать локальное видео |
OFF | Скрывать локальное видео |
TOGGLE | Переключить локальное видео |
GET | Запросить состояние локального видео |
# SETDEVICE
Выбрать устройство для захвата или вывода медиапотоков, а также трансляции контента.
В перечисленных далее командах используется параметр DeviceId
— идентификатор устройства. Его можно получить с помощью команды LISTDEVICE
.
Параметр | Описание |
---|---|
AUDIO CAPTURE [DeviceId] | Выбрать устройство DeviceId для захвата звука |
AUDIO RENDER [DeviceId] | Выбрать устройство DeviceId для вывода звука |
VIDEO CAMERA [DeviceId] | Выбрать устройство DeviceId для захвата основного видеопотока (в качестве камеры) |
VIDEO PRESENTATION [DeviceId] | Выбрать устройство DeviceId для захвата дополнительного видеопотока (в качестве контента) |
SETDEVICE VIDEO PRIMARY [DeviceId] | Выбрать дисплей для отображения видео основного потока |
SETDEVICE VIDEO SECONDARY [DeviceId] | Выбрать дисплей для отображения видео дополнительного потока |
VIDEODUAL ALL | Включить второй дисплей |
VIDEODUAL OFF | Отключить второй дисплей |
VIDEODUAL MIRROR | Дублирование на втором дисплее изображения основного монитора |
VIDEODUAL PRESENTATION | Выводить на втором мониторе дополнительный поток (демонстрируемый контент) |
# SHUTDOWN
Выключить TrueConf Group.
Команда аналогична нажатию кнопки Shutdown в разделе Settings → Power supply → Power control панели управления терминалом.
Данная команда выполняется сразу после её отправки, без предварительного запроса подтверждения (в отличие от аналогичного действия в панели управления).
# SPEAKERMUTE
Управление выводом звука.
Параметр | Описание |
---|---|
ON | Отключить вывод звука |
OFF | Активировать вывод звука |
GET | Запросить состояние вывода звука |
REGISTER | Подписаться на получение уведомлений на отключение/включение вывода аудио: в консоль будут выводиться соответствующие уведомления. Данные сообщения будут поступать до их отключения с помощью команды UNREGISTER и только в текущем сеансе подключения по SSH. |
UNREGISTER | Отключить уведомления об изменении состояния вывода звука |
# VIDEOCODEC
Разрешить или запретить использование видеокодека.
Параметр | Описание |
---|---|
[CODEC] ON | Разрешить использовать видеокодек [CODEC] |
[CODEC] OFF | Запретить использовать видеокодек [CODEC] |
[CODEC] GET | Получить текущее состояние кодека [CODEC] |
GET | Получить текущее состояние всех видеокодеков |
Learn more about all codecs supported by the endpoint in the Supported protocols and codecs section.
# VIDEOMIXER
Задать режим микширования потоков для многоточечного соединения (MCU).
Параметр | Описание |
---|---|
VIDEOLESSON | Режим видеоурока, при котором подключенные участники видят и слышат только ведущего, в качестве которого выступает терминал. При этом все слышат друг друга. |
ALL | Режим "все на экране", когда все участники видят и слышат друг друга |
ACTIVESPEAKER | Режим активации по голосу, при котором все видят и слышат друг друга, и в приоритетном видеоокне в раскладке будет отображаться активный говорящий |
# VOLUME
Управление уровнем громкости для вывода звука.
Параметр | Описание |
---|---|
UP | Повышение уровня громкости |
DOWN | Понижение уровня громкости |
GET | Вывести в консоль текущий уровень громкости (в процентах) |
REGISTER | Подписаться на получение уведомлений об увеличении/уменьшении уровня громкости: в консоль будут выводиться соответственно сообщения event: volume up и event: volume down .Данные сообщения будут поступать до их отключения с помощью команды UNREGISTER и только в текущем сеансе подключения по SSH. |
UNREGISTER | Отключить уведомления об изменении громкости звука |
Управлять уровнем громкости также можно путём отправки команд RCKEY VOL+
и RCKEY VOL-
.
# WHOAMI
Вывод информации о TrueConf Group.
Пример работы команды:
(tcg cli) whoami
Information about the system:
Display Name:"TrueConf Group"
Serial Number:"TCG01B9209863"
License Type:"permanent"
Software version:"1.1.0.470"
IP address:"10.160.2.55"
MAC:"FC:34:97:67:62:5F"
SIP:"sip:10.160.2.55"
H323:"h323:10.160.2.55"
H323 Gatekeeper:""
SIP Server:""
H323 Name:""
H323 Extension:""
Display information:
Name:""
Connected:"True"
Active:"True"
Mode:"3840x2160@30.0 [30.0]"
# Уведомления
# audiomute off
Микрофон был включен.
# audiomute on
Микрофон был выключен.
# cameramute off
Камера была включена.
# cameramute on
Камера была выключена.
# Dial failed
Вызов завершился до его принятия, например, по истечении таймаута.
# Hangup call
Уведомление при завершении сеанса связи с определённым абонентом. Обратите внимание на ID [259]
– это значение идентификатора вызова [CallID]
, которое также отображается в выводе команд CALLINFO, HANGUP, и в уведомлении Incoming call, Outgoing call.
For example:
Hangup call [259]:
Name:"Jhon Doe"
Contact URI:"h323:doe@10.110.2.240:1720"
Protocol:"H.323"
# Incoming call
Уведомление, которое отображается:
при поступлении входящего вызова, в этом случае дополнительно будет присутствовать слово
ringing
;после принятия входящего вызова, в этом случае дополнительно будет присутствовать слово
confirmed
.
Обратите внимание на ID [260]
в примерах ниже – это значение идентификатора вызова [CallID]
. Данный ID также отображается в выводе команд CALLINFO, HANGUP, и в уведомлениях Outgoing call, Hangup call.
Incoming call notification
Incoming call [260], ringing:
Name:"Joe Smith"
Contact URI:"h323:111@video.example.com:1720"
Protocol:"H.323"
User agent:"TrueConf Gateway 4.3"
Пример уведомления после принятия вызова:
Incoming call [260] confirmed:
Name:"Joe Smith"
Contact URI:"h323:111@video.example.com:1720"
Protocol:"H.323"
User agent:"TrueConf Gateway 4.3"
# Outgoing call
Уведомление, которое отображается:
при совершении терминалом исходящего вызова, в этом случае дополнительно будет присутствовать слово
ringing
;после принятия абонентом вызова от терминала, в этом случае дополнительно будет присутствовать слово
confirmed
.
Обратите внимание на ID [259]
в примерах ниже – это значение идентификатора вызова [CallID]
. Данный ID также отображается в выводе команд CALLINFO, HANGUP, и в уведомлениях Incoming call, Hangup call.
Incoming call notification
Outgoing call [259], ringing:
Name:"111"
Contact URI:"h323:111@10.110.2.240:1720"
Protocol:"H.323"
User agent:""
Пример уведомления после принятия вызова:
Outgoing call [259] confirmed:
Name:"111"
Contact URI:"h323:111@10.110.2.240:1720"
Protocol:"H.323"
User agent:"TrueConf Gateway 4.3"
# speakermute off
Устройство вывода звука было включено.
# speakermute on
Устройство вывода звука было выключено.