Клиентские приложения 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:
Авторизация	trueconf:login=[login]&password=[password]&encrypt=1 trueconf:login=user&password=pswd&encrypt=1
Авторизация на другом сервере	trueconf:login=[login]@[TrueConfServer]&password=[password]&encrypt=1 trueconf:login=user@192.168.12.123&password=pswd&encrypt=1
Вызов пользователя
Звонок в рамках сервера	trueconf:[user] trueconf:ivan
Звонок на другой сервер	trueconf:[user]@[TrueConfServer] trueconf:ivan@192.168.12.123
Присоединение к конференции
Присоединение к конференции \c\CID	trueconf:\c\[CID] trueconf:\c\4154248070 trueconf:4154248070&conftype=multi
Звонок в конференцию, где [user] — ведущий	trueconf:[user]&conftype=hotquery trueconf:ivan&conftype=hotquery
Подключение к трансляции
Присоединиться к RTSP-трансляции	trueconf:[#rstp] trueconf:#rtsp://domainn.company.com:554
Другие функции
Закрыть приложение после завершения звонка/конференции	Добавить &autoclose=1 в конец любой команды trueconf:ivan&autoclose=1

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

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

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

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

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

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