Протокол «trueconf:» для взаимодействия с клиентскими приложениями TrueConf

Константин Ольмезов
12.04.2018
Константин Ольмезов
Категории: База знаний

Клиентские приложения TrueConf поддерживают специальный протокол trueconf:, который действует на уровне операционной системы и позволяет управлять вызовами и другими функциями через короткие команды, которые можно поместить в ссылку или кнопку в браузере, запустить в консоли или вставить в скрипт.

Протокол trueconf: поддерживается для клиентских приложений версии 7+, а для TrueConf Client 6.x.x через него доступны лишь самые основные функции.

Предыдущее наименование протокола – visicall: – на данный момент является устаревшим и может не распознаваться новыми приложениями. Его использование не рекомендуется.

В этой статье мы опишем основные возможности протокола и покажем примеры его использования. Для наглядности мы приводим только примеры его использования в виде ссылки в браузере.

Формат обращения к протоколу trueconf:

Все возможные вызовы протокола trueconf: можно описать в общем виде как:

trueconf:[target]@[TrueConfServer]&[param_1]=[value_1]&[…]&[param_n]=[value_n]

Здесь:

  • [target] — логин пользователя, id конференции, rtsp-ссылка для подключения и т. д.
    Далее мы будем называть этот параметр адресатом;
  • [TrueConfServer]IP-адрес или FQDN-имя сервера TrueConf, на который должен быть направлен звонок;
  • [param_n]название дополнительного параметра;
  • [value_n] — название дополнительного параметра;
  • […] — другие дополнительные параметры, которые задаются аналогично первому и последнему.

Какие действия поддерживает протокол?

Функция Формат и примеры вызова Версия 6.X Версия 7.X
Запуск и авторизация
Запуск приложения trueconf: v v
Авторизация  trueconf:login=[login]&password=[password]&encrypt=1

trueconf:login=user&password=pswd&encrypt=1

v v
Авторизация на другом сервере  trueconf:login=[login]@[TrueConfServer]&password=[password]&encrypt=1

trueconf:login=user@192.168.12.123&password=pswd&encrypt=1

v v
Вызов пользователя
Звонок в рамках сервера trueconf:[user]

trueconf:ivan

v v
Звонок на другой сервер trueconf:[user]@[TrueConfServer]

trueconf:ivan@192.168.12.123 

v v
Присоединение к конференции
 Присоединение к

конференции \c\CID

 trueconf:\c\[CID]

trueconf:\c\4154248070

trueconf:4154248070&conftype=multi

x v
 Звонок в конференцию,

где [user] — ведущий

 trueconf:[user]&conftype=hotquery

trueconf:ivan&conftype=hotquery

x v
Подключение к трансляции
Присоединиться к RTSP-трансляции trueconf:[#rstp]

trueconf:#rtsp://domainn.company.com:554

x v
Другие функции
Закрыть приложение после завершения звонка/конференции  Добавить &autoclose=1 в конец любой команды

trueconf:ivan&autoclose=1

x v

Авторизацию пользователя и звонок в конференцию или другому пользователю можно соединить в одной команде, например:

trueconf:\c\4154248070&login=user&password=pswd&encrypt=1

Как сменить приложение, используемое по умолчанию?

Иногда случается так, что на компьютере пользователя установлены два клиентских приложения TrueConf одновременно — классическое (TrueConf Client) и новое (TrueConf для Windows), но команды, управляемые протоколом trueconf: всё равно направляются в устаревшую версию приложения.

Это означает, что TrueConf Client был установлен позже, чем TrueConf для Windows, потому что команды протокола trueconf: направляются на последнюю установленную (или обновлённую) версию приложения.

Как мы уже писали выше, протокол trueconf: предназначен для использования в TrueConf для Windows, так что желательно направить выполнение именно на него. Для этого скачайте и установите его заново (удалять его перед этим не обязательно).