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

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

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

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

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

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

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

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

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

Здесь:

  • [target] — логин пользователя, id конференции или любая другая строка вызова;
  • [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:h=[TrueConfServer]&login=[login]&password=[password]&encrypt=1

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

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

trueconf:ivan

v v
Вместо имени пользователя сервера вы можете использовать любую строку вызова. Например:
Звонок на другой сервер trueconf:[user]@[TrueConfServer]

trueconf:ivan@conf.company.com

v v
Присоединиться к RTSP-трансляции trueconf:#[rtsp_address]
обязательно замените все слэши / на %2f
trueconf:#rtsp:%2f%2fdomainn.company.com:554
x v
Присоединение к конференции
 Присоединение к

конференции по ID [CID]

 trueconf:[CID]&conftype=multi

trueconf:4154248070&conftype=multi

v v
trueconf:\c\[CID]

trueconf:\c\4154248070

x v
 Звонок в конференцию, где [user] — ведущий  trueconf:[user]&conftype=hotquery

trueconf:ivan&conftype=hotquery

v 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, так что желательно направить выполнение именно на него. Для этого скачайте и установите его заново (удалять его перед этим не обязательно).

Подписка на новости