Документация TrueConf

# Форматы строки вызова

TrueConf Server позволяет соединять в видеозвонках и конференциях не только пользователей сервера, но и SIP, H.323 и RTSP устройства. Для различных типов устройств предусмотрены специальные форматы строки вызова, однозначно (для данного сервера) идентифицирующие абонента, с которым нужно связаться.

Строка вызова — важный, повсеместно используемый в приложениях TrueConf инструмент. Форматы строки вызова можно использовать:

  • при поиске абонента через клиентское приложение;

  • при вызове абонента из клиентского приложения;

  • при добавлении абонента в адресную книгу;

  • при добавлении участника конференции;

  • при создании псевдонима;

  • и т. д.

# Совершение звонка пользователю TrueConf Server

Для звонка пользователю вашего сервера укажите в качестве строки вызова его TrueConf ID.

В качестве абонента может выступать также пользователь другого сервера TrueConf Server (только если между серверами настроена федерация). Для этого используйте строку вызова в формате <TrueConf_ID>@<server>, где:

  • <TrueConf_ID> — ID пользователя;

  • <server> — IP-адрес или имя сервера, на который нужно направить вызов.

# Подключение к конференции

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

Также можно использовать строку вызова в следующем формате:

  • \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 на TrueConf Server →