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