# Подключение к TrueConf Server
Для использования системы видеоконференцсвязи вам необходимо иметь на своём устройстве одно из клиентских приложений TrueConf.
# Возможности клиентских приложений
С нашими клиентскими приложениями вы сможете:
просматривать адресную книгу и группы пользователей;
настраивать работу приложения в соответствии с индивидуальными предпочтениями;
проводить видеоконференции (в т. ч. видеозвонки один-на-один) и присоединяться к ним;
- участвовать в голосованиях во время конференции;
транслировать собеседникам содержимое своего экрана или презентации;
изменять раскладки видеоокон на экране во время видеоконференции;
обмениваться с другими пользователями файлами и текстовыми сообщениями;
просматривать историю сообщений и видеозвонков;
выбирать используемое для видеосвязи оборудование;
настраивать эхоподавление, шумоподавление и другие эффекты.
# Где взять клиентские приложения
Вы можете скачать клиентские приложения для всех поддерживаемых платформ с гостевой страницы вашего TrueConf Server (ее адрес можно уточнить у администратора сервера) или со страницы нашего официального сайта.

# Для каких платформ существуют клиентские приложения TrueConf
К проводимым на сервере конференциям можно подключиться со следующих платформ:
Windows
macOS
Linux
Android
Android TV
iOS
iPadOS
watchOS
WebRTC
Подключение по WebRTC доступно только пользователям, имеющим ссылку на веб-страницу видеоконференции.
# Подключение клиентского приложения
Чтобы приложение подключилось к TrueConf Server, укажите адрес сервера в сети и пройдите авторизацию. Более подробную информацию вы можете узнать у администратора сервера.
# Как происходит обновление клиентских приложений
Клиентские приложения TrueConf для Windows встроены в установочный пакет TrueConf Server и обновляются автоматически при обновлении сервера. Приложения для Linux доступны на нашем сайте, а также в репозитории каждой из операционных систем. Все способы установки приложения TrueConf для Linux смотрите в соответствующей статье нашей базы знаний.
Для обновления остальных приложений нужно вручную скачивать новую версию с нашего сайта или получать обновления через магазин приложений для Android, Android TV, iOS и macOS.
# Форматы строки вызова
TrueConf Server позволяет соединять в видеозвонках и конференциях не только пользователей сервера, но и SIP, H.323 и RTSP устройства. Для различных типов устройств предусмотрены специальные форматы строки вызова, однозначно (для данного сервера) идентифицирующие абонента, с которым нужно связаться.
Строка вызова — важный, повсеместно используемый в приложениях TrueConf инструмент. Форматы строки вызова можно использовать:
при поиске абонента через клиентское приложение;
при вызове абонента из клиентского приложения;
при добавлении абонента в адресную книгу;
при добавлении участника конференции;
при создании псевдонима;
и т. д.
# Совершение звонка пользователю TrueConf Server
Для звонка пользователю вашего сервера укажите в качестве строки вызова его TrueConf ID.
В качестве абонента может выступать также пользователь другого сервера TrueConf Server (только если между серверами настроена федерация). Для этого используйте строку вызова в формате <TrueConf_ID>@<server>
, где:
<TrueConf_ID>
— ID пользователя;<server>
— IP-адрес или имя сервера, на который нужно направить вызов.
# Подключение к конференции
Используйте строку вызова в следующем формате:
\c\<CID>
если конференция проходит на вашем сервере, где:<CID>
— ID конференции;
\c\<CID>@<server>#vcs
если конференция проходит на другом сервере TrueConf Server и между серверами настроена федерация, где:<CID>
— ID конференции;<server>
— DNS-имя сервера, на котором проходит конференция.
# Форматы вызова SIP-устройств
Для вызова SIP-устройств используйте один из следующих форматов:
#sip:<user_id>@<server_name>
, где:<server_name>
— имя сервера SIP или IPv4-адрес;<user_id>
— имя пользователя SIP на сервере.
#sip:<user_id>@[<server_name>]
, где:<server_name>
— IPv6-адрес SIP;<user_id>
— имя пользователя SIP на сервере.
#sip:<user_id>
, где:<user_id>
— имя пользователя SIP на сервере;
#sip:@<endpoint_ip>
, где:<endpoint_ip>
— IPv4-адрес пользователя SIP.
#sip:@[<endpoint_ip>]
, где:<endpoint_ip>
— IPv6-адрес пользователя SIP.
#sip:@<hostname>
, где:<hostname>
— DNS-имя терминала SIP;
#tel:<number>
, где:<number>
— имя пользователя SIP на сервере.
Аналогичный вызов будет осуществлён при звонке из номеронабирателя на номер <number>
.
При укаказании IP или имени сервера SIP может быть необходимым дополнительно в явном виде указать:
порт
<port>
для подключения (в случае, если отличается от стандартного 5060);транспортный протокол
<protocol>
для передачи медиапотоков (по умолчанию используется UDP).
Тогда эти параметры пишутся после адреса сервера в виде :<port>;transport=<protocol>
.
Примеры вызовов по протоколу SIP:
#sip:james78@sip.company.com
#sip:james78@sip.company.com:5070
#sip:james78@sip.company.com:5070;transport=tcp
#sip:james78
#sip:8001
#sip:@192.168.1.99
#sip:@192.168.1.99;transport=tcp
#sip:@[fe80::805a:1cf9:12f9:def7]
#tel:501
#tel:13478783263
# Звонки на телефон
Позвонить на телефонный номер можно с помощью номеронабирателя клиентского приложения. Более подробно об этом функционале вы можете прочитать в руководстве пользователя клиентских приложений TrueConf.
# Форматы вызова H.323-устройств
Для вызова H.323-устройств доступны следующие форматы:
#h323:@<IP>
, где:<IP>
— IP-адрес H.323 гейткипера.
#h323:@[<IP>]
, где:<IP>
— IPv6-адрес H.323 гейткипера.
#h323:<user_id>@<IP>
, где:<IP>
— IP-адрес H.323 гейткипера или MCU;<user_id>
— ID пользователя или устройства, зарегистрированного на H.323 гейткипере с IP-адресом, указанным в параметре<IP>
.
#h323:<user_id>@[<IP>]
, где:<IP>
— IPv6-адрес H.323 гейткипера или MCU;<user_id>
— ID пользователя или устройства, зарегистрированного на H.323 гейткипере с IP-адресом, указанным в параметре<IP>
.
#h323:\e\<e164_id>@<IP>
, где:<IP>
— IP-адрес H.323 гейткипера или MCU;<e164_id>
— номер в формате E.164 пользователя или устройства, зарегистрированного на H.323 гейткипере с IP адресом, указанным в параметре<IP>
.
#h323:<user_id>
, где:<user_id>
— ID вызываемого H.323 гейткипера.
#h323:\e\<e164_id>
, где:<e164_id>
— номер в формате E.164 вызываемого H.323 гейткипера.
При укаказании IP-адреса H.323 гейткипера или MCU может быть необходимым дополнительно в явном виде указать порт <port>
для подключения (в случае, если отличается от стандартного 1720). Тогда он указывается после IP в виде:
#h323:<user_id>@<IP>:<port>
Примеры вызова по протоколу H.323:
#h323:@192.168.1.99
#h323:@192.168.1.99:1730
#h323:hdx8000@192.168.1.99
#h323:@[fe80::805a:1cf9:12f9:def7]
#h323:james78
#h323:\e\8001
# Формат вызова RTSP-устройств
Для отображения RTSP-трансляции добавьте её источник в качестве абонента в конференцию или видеозвонок один-на-один, используя строку вызова RTSP. Например, так можно получить изображение с IP-камеры или другой конференции, которая транслируется по RTSP. Формат строки для камер различных производителей и моделей может отличаться, поэтому уточняйте его для вашего конкретного устройства.
Примеры RTSP-адресов для различных камер:
rtsp://192.168.1.100/axis-media/media.amp
rtsp://admin:12345scw@192.168.1.100:554/cam/realmonitor?channel=1&subtype=1
rtsp://admin:12345@192.168.1.100:554/Streaming/Channels/101
Пример RTSP-ссылки на конференцию TrueConf, для которой включена трансляция:
rtsp://video.server.com/c/webinar/
# Использование тонового набора
Вы можете отправлять DTMF-команды на поддерживающие их устройства при помощи режимов RTP EVENT (opens new window) и SIP INFO (opens new window). Для более детальной информации о передаче этих сигналов читайте документацию, прилагаемую производителем к конкретной модели.
Доступно добавление пауз непосредственно в строку вызова с помощью следующих символов:
,
— короткая пауза (несколько секунд);;
— длинная пауза (ожидание ответного гудка от абонента).
Например, для звонка c клиентского приложения TrueConf на SIP-сервер с IP 192.168.1.99
в конференцию, защищённую PIN-кодом 123456
, можно использовать URI с донабором, что избавит от ручного ввода PIN при подключении:
#sip:@192.168.1.99;123456
Для звонка по номеру телефона 13478783263
с указанием добавочного номера 222
можно использовать строку вызова вида:
#tel:13478783263,222
# Звонок с SIP/H.323 терминала
Для звонка с аппаратного или программного SIP/H.323 терминала в конференцию, проводимую на TrueConf Server, используйте строку вызова в одном из следующих форматов:
00<Conference_ID>@<server>
00<Conference_ID>@<server>:<port>
где:
<Conference_ID>
— ID конференции;<server>
— IP-адрес или имя сервера;<port>
— порт для подключения (в случае, если отличается от стандартных5060
для SIP и1720
для H.323).
Например:
001949195144@video.company.com
001949195144@video.company.com:1730
Чтобы подключиться с SIP-терминала к защищённому PIN-кодом мероприятию, требуется добавить PIN через запятую после ID конференции в строке вызова:
00<conf_id>,pin@<trueconf_server>:<port>
Чтобы позвонить с терминала пользователю, зарегистрированному на TrueConf Server, используйте один из следующих форматов:
<TrueConf_ID>@<server>
<TrueConf_ID>@<server>:<port>
где:
<TrueConf_ID>
— TrueConf ID пользователя;<server>
— IP-адрес или имя сервера, на который нужно направить вызов;<port>
— порт для подключения (в случае, если отличается от стандартных5060
для SIP и1720
для H.323).
Например:
james78@video.company.com
james78@video.company.com:5070
Дополнительно для вызова по протоколу SIP можно в явном виде указать название протокола, по умолчанию используется UDP:
00<conf_id>,pin@<trueconf_server>:<port>;transport=<protocol>
Также звонки с H.323 терминалов пользователям и в конференции TrueConf возможно совершать в виде:
<trueconf_server>##00<user>
<trueconf_server>##00<conf_id>