# Подключение к TrueConf Server

Для использования системы видеоконференцсвязи вам необходимо иметь на своём устройстве одно из клиентских приложений TrueConf.

# Возможности клиентских приложений

С нашими клиентскими приложениями вы сможете:

# Где взять клиентские приложения

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

/server/media/guest/ru.png

# Для каких платформ существуют клиентские приложения 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> если конференция проходит на вашем сервере, где:

  • \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>