Как подключить гостя к конференции напрямую
Решения TrueConf позволяют реализовать множество сценариев использования ВКС в различных сферах бизнеса, образования и науки, здравоохранения, государственной деятельности и пр. Но ещё больше расширить возможности видеосвязи можно с помощью TrueConf Server API – набора готовых методов для взаимодействия ваших приложений с TrueConf Server.
Ниже мы покажем, как можно обеспечить подключение гостя (участника, не имеющего учётной записи на вашем сервере ВКС) к конференции напрямую без ручного ввода гостевого имени.
Это может быть полезно, например, при использовании решений TrueConf в области телемедицины. Представим, что у врачей установлено специализированное приложение, в которое интегрирована возможность онлайн-консультаций по видеосвязи. Пользователь авторизуется в личном кабинете на сайте медицинских услуг и записывается на виртуальный приём в определённое время. При этом для врачей созданы учётные записи на сервере, а для клиентов их добавлять не требуется.
Мы рассмотрим подключение гостя как с помощью браузера (по WebRTC), так и с помощью клиентского приложения. Второй вариант предоставляет больше возможностей участия в видеоконференции. Таким образом, вы сможете разместить на своём сайте ссылки для присоединения через браузер и через клиентское приложение TrueConf, как это сделано на стандартной странице подключения к конференции.
Предварительная настройка TrueConf Server
- Убедитесь в наличии необходимого количества гостевых подключений в вашей лицензии в разделе Информация о сервере → Информация панели управления TrueConf Server.
В базовой поставке TrueConf Server Free есть возможность создавать публичные конференции, но одновременно поддерживается 1 гостевое подключение. Если требуется увеличить их число – обратитесь в отдел продаж для их покупки или активации на пробный период длительностью до 3 недель.
- Настройте HTTPS-соединение для обеспечения работы API.
Для дальнейших шагов используются различные методы API сервера, работающие по протоколу OAuth 2.0. Что это такое и как настроить взаимодействие с TrueConf Server по этому протоколу, читайте в нашей статье “Как начать работу с TrueConf API”.
Шаг 1. Создание запланированной публичной конференции
С помощью метода Create Conference создайте новую видеоконференцию, указав следующие параметры:
- владелец и список участников – для обоих параметров укажите TrueConf ID (логин) врача;
- количество участников – 2;
- тип запуска – с расписанием, то есть в объекте Schedule должны быть указаны тип запуска 1 (одноразовый запуск), время начала в формате Unix Timestamp, и длительность консультации в секундах;
- тип конференции – публичная;
- режим – все на экране;
- запись – включена, т.к. по закону все видеоконсультации в сфере медицины должны записываться. Чтобы это было возможно, в соответствующем разделе панели управления сервером должна быть включена запись конференций по запросу.
Например, при планировании консультации на 01.06.2021 в 12:00 МСК (GMT +3) длительностью 30 минут, получим такой объект Conference для передачи в теле запроса:
В ответ вы получите JSON созданного объекта конференции. При этом ID конференции будет создан автоматически, например, 0987654321.
Шаг 2. Формирование ссылок для автоматического подключения гостей
Теперь вы можете создать и предоставить пациенту ссылку для автоматического подключения к видеоконсультации. При этом имя может браться, например, из данных его профиля на сайте медуслуг.
- Получите авторизационные данные с помощью GET-метода Software_Clients – Get Client List.
При этом укажите такие параметры:
call_id: 0987654321
– ID созданной конференции;case: join_conference_button
– генерация прямых ссылок для подключения с помощью клиентских приложений;user: $Иван Иванов
– отображаемое в конференции имя гостя (обязательно с символом $).
В нашем примере запрос будет иметь вид:
- Ответ будет содержать в себе JSON со списком всех приложений для подключения к конференции, в том числе JSON-объект с именем
"name": "TrueConf Web"
и данными для подключения по WebRTC: - Значение параметра
web_url
– это ссылка для автоматического подключения через браузер участника к онлайн-консультации. - Также в JSON будет присутствовать объект
"deeplinks"
со ссылками для подключения с помощью клиентских приложений TrueConf. При этом ссылка"default"
используется для TrueConf для десктопов (Windows, Linux, macOS) и TrueConf для iOS/iPadOS, а ссылка"android"
– для TrueConf для Android/Android TV: - Требуется заменить двойные слэши на одинарные, то есть получим ссылки вида:
Тогда при наличии в системе приложения TrueConf по нажатию на такую ссылку произойдёт его открытие и подключение к мероприятию.
Обратите внимание, что полученные с помощью данного запроса ссылки – временные, и в целях безопасности срок их действия ограничен 1 минутой. Потому подключиться надо сразу после их генерации, например, создавать их непосредственно при нажатии на кнопку присоединения, которую вы добавите на сайте.
Шаг 3. Добавление конференции в календарь
Чтобы пациент и врач не пропустили видеоконсультацию, добавьте её в их личные календари. Для этого предоставьте обоим участникам ссылки для интеграции, получив их с помощью GET-запроса Get Conference Calendars. В ответ вы получите JSON, который содержит ссылки для добавления мероприятия в календари Google, Outlook, и файл ics для других сервисов.
Шаг 4. Получение услуг телемедицины
Когда наступит время видеоконсультации, конференция автоматически начнётся и врач получит в неё вызов. Пациенту же надо будет перейти по ссылке, которую он добавил в свой календарь, и он сразу подключится к мероприятию под своим именем.
Для проверки вы можете перейти по данной ссылке в браузере. Если ранее в нём не были даны разрешения на доступ к оборудованию, то появится окно настройки микрофона и камеры перед подключением.
Обратите внимание!
Корректно данный метод работает только при переходе гостем в запланированную конференцию после времени её начала, т.к. подключиться заранее к ней может только её владелец.