Визуализация (WebRTC)

В этом разделе описывается настройка визуализации как участника WebRTC. В разделе SIP-участник подробнее объясняется интеграция участников.

Важное примечание: WebRTC работает только с помощью HTTPS и действительного сертификата. В противном случае голосовая связь не будет установлена.

Сигнальная станция

Телефон на визуализации нельзя вызвать по звонку. Поэтому сигнал должен быть передан отдельно через Сообщения или физический гонг. Затем пользователь может установить голосовую связь с абонентом, позвонив с визуализации.

Чтобы принять сигнал, можно либо отправить команду напрямую через TCP/UDP- или HTTP-интерфейс от абонента, если он поддерживает это. Альтернативно можно распознать входящий звонок через Asterisk AMI-интерфейс или с помощью события План набора номера. Последний вариант проще всего реализовать.

Настройка

В отличие от телефона, адресная настройка визуализации создается автоматически сервером. Поэтому не нужно настраивать SIP-адреса.

Чтобы использовать телефон в визуализации, он добавляется с помощью плагина Библиотека на страницу. Если настройка телефона завершена и Asterisk-телефонная станция успешно запущена, в правом нижнем углу визуализации отображается FAB (Floating Action Button). Это позволяет пользователю установить соединение.

Настройка VoIP-телефонии разделена на две части. Настройка серверов для визуализации выполняется в Сетевом интерфейсе или в Удалённом доступе. Все настройки для телефонной станции выполняются в Инфраструктуре под Сеть ▸ Телефония. Настройки выглядят похоже, поэтому важно обратить внимание на то, где выполняются настройки. Обычно используются те же настройки, если сервер находится в той же сети. По умолчанию настройки телефонии распространяются на все сетевые соединения.

Использование по всему миру

Чтобы визуализация могла устанавливать голосовую связь по всему миру, WebRTC-UDP-пакеты должны достигать внутренней телефонной станции. Если вы находитесь в той же сети или подключаетесь через VPN, пакеты напрямую достигают сервера и связь работает. Иначе обстоит дело, если визуализация вызывается из другой сети. Тогда IP-адрес сервера недоступен. Для этого есть два решения:

  • STUN-сервер: он разрешает каждую NAT-IP и предоставляет эти адреса визуализации. Затем она пытается установить соединение с каждой из этих IP-адресов.
  • TRUN-сервер: голосовая связь устанавливается напрямую через TURN. То есть, связь перенаправляется на TURN.

Вся информация о настройке содержится в разделе STUN- и TRUN-серверы.

Клавиатура

Под правой вкладкой в настройке телефона можно задать клавиатуру для визуализации. Вот пример обычной телефонной панели:

!1;!2;!3
!4;!5;!6
!7;!8;!9
[icon:material/emergency]:*;!0;!#

Или использование дверного открывателя:

[icon:material/door_open] [txt:Open]:*1234#

Каждая цифра отделяется точкой с запятой в строке. Если содержимое оставлено пустым, кнопка пропускается соответствующим образом. Каждая кнопка может содержать индивидуальный текст. Текст просто пишется перед кодом с помощью двоеточия. Также поддерживаются заполнители [icon:] и [txt:] для переводов. Восклицательный знак перед текстом увеличивает шрифт панели кнопок. Если используется только код, он не передается. Если вставлена пустая строка, начинается новая таблица.

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

Допустимые символы: 0-9, A-D, * и #. Также можно вставить паузу с помощью запятой (,). Для более длительных пауз повторите запятую несколько раз.

Поиск ошибок

Чтобы проверить, может ли быть установлено внешнее соединение, рекомендуется использовать консоль браузера Chrome. Ее можно вызвать по URL chrome://webrtc-internals/.

В разделе ICE candidate grid можно, например, отобразить требования к IP-адресам.

Известные проблемы

  • На старых устройствах iOS нельзя установить соединение, если веб-приложение используется в полноэкранном режиме (PWA). На 01.10.2019 (iOS13.1).
  • На некоторых устройствах iOS громкость может быть очень тихой. Дважды нажав на микрофон (голосовой вызов), громкость увеличивается.
  • Нельзя установить соединение без HTTPS, так как большинство браузеров требуют защищенной голосовой связи.