Конфигурирование и обзор возможностей видеоконференции стандартными средствами Asterisk 16

Начиная с 15-й версии Asterisk появился полноценный функционал организации видеоконференций, но наблюдались некоторые проблемы в виде рассыпания видеокартинки. В 16 версии данный функционал был доработан и улучшен режим работы с мультипотоком «SFU»(когда приходящие видео потоки рассылаются всем участникам конференции, которые поддерживают прием нескольких потоков, т.е. получаем полноценный MCU на базе Asterisk).

В статье использовались файлы:

cyber_mega_phone_2k-master.zip — простое клиентское приложение на стороне браузера, созданное для тестирования многопотоковых возможностей Asterisk на основе библиотеки JsSIP.

Инструкция

1.                      Выполним предварительные настройки FreePBX, для этого перейдём в WEB панель управления FreePBX через интернет обозреватель(Opera, Firefox, Google Chrome, Yandex Browser….) по ссылке вида: http://IP_адрес_сервера_Asterisk/ В примере ссылка имеет вид: http://192.168.170.163/

2.                      Пройдём авторизацию во FreePBX, нажмём «FreePBX Administration», введем «username и password» и нажмём «Continue»

3.                      Перейдем в меню Settings -> Advanced Settings и  включим «Asterisk Builtin mini-HTTP server»

Enable the mini-HTTP Server — установите значение «true»
Enable Static Content — установите в значение «true»
Enable TLS for the mini-HTTP Server — установите в значение «true»
HTTP Bind Address — установите значение «0.0.0.0»
HTTP Bind Port — установите значение «8088»
HTTPS Bind Address — установите значение «0.0.0.0»
HTTPS Bind Port — установите значение «8089»
HTTPS TLS Certificate Location – установите директорию расположения SSL сертификата(по умолчанию: /etc/asterisk/keys/integration/certificate.pem, рекомендуется использовать  LetsEncrypt  сертификат вместо самоподписанного или приобрести сертификат )
HTTPS TLS Private Key Location — установите директорию расположения приватного ключа сгенерированного вместе с SSL сертификатом(по умолчанию: /etc/asterisk/keys/integration/webserver.key, рекомендуется использовать  LetsEncrypt  ключ вместо самоподписанного или приобрести сертификат)

4.           Перейдем в меню Settings -> Advanced Settings и  включим возможность подключения по WebSocket

ws — 0.0.0.0 – All — установите значение «Yes»
wss — 0.0.0.0 – All — установите значение «Yes»

5.           Выполним подключение по SSH к серверу IP АТС Asterisk. В зависимости от используемой системы(Windows, Linux, MacOS), подключение по SSH можно выполнить с использованием различного дополнительного программного обеспечения(Putty), либо системного терминала.

6.           Создадим гостевую кастом учетную запись PJsip:

# nano /etc/asterisk/pjsip_custom.conf

Следующего вида:

[guest]
type=aor
max_contacts=5 ;Ограничения максимально зарегистрированных Sip User agent на данную учетную запись
[guest]
type=endpoint
context=from-internal ;Контекст для осуществления исходящих звонков
direct_media=no ;Обработкой медиа трафика будет заниматься Asterisk
disallow=all
allow=ulaw,vp8,h264;Разрешенные кодеки
aors=guest
max_audio_streams=10 ; максимальное количество аудио каналов
max_video_streams=10 ; максимальное количество видео каналов
webrtc=yes ;разрешить использовать WebRTC
use_avpf=yes
rtcp_mux=yes
media_encryption=dtls
dtls_verify=fingerprint
dtls_cert_file=/etc/asterisk/keys/voxlink.crt
dtls_private_key=/etc/asterisk/keys/voxlink.key
dtls_setup=actpass
dtls_rekey=0

7. Создадим дополнительный профиль телеконференции:

# nano /etc/asterisk/confbridge_custom.conf

Следующего вида:

[sfubridge]
type=bridge
video_mode=sfu ;включения режима работы видео в мультипотоке
[sfuuser]
type=user
music_on_hold_when_empty=yes ;Проигрывание музыки ожидания если в конференции один участник
music_on_hold_class=default ; Класс музыки ожидания используемый по умолчанию
[sfumenu]
type=menu
*=playback_and_continue(conf-usermenu)
*1=toggle_mute ;включение/отключение микрофона
1=toggle_mute ;включение/отключение микрофона

8. Создадим два экстена для проверки видео конференц связи:

# nano /etc/asterisk/extensions_custom.conf

Следующего вида:

exten => 911,1,Answer() ; Эхо тест
  same => n,StreamEcho(3)
  same => n,Hangup()

exten => 912,1,Answer() ; Конференц комната с задействованным профилем конференции 
  same => n,ConfBridge(912,sfubridge,sfuuser,sfumenu)
  same => n,Hangup()

9. Приступим к установке Cyber Mega Phone:

# cd /var/www/html/
# git clone https://github.com/asterisk/cyber_mega_phone_2k.git
# mv cyber_mega_phone_2k cmp2k

10. Перейдём в WEB панель управления Cyber Mega Phone через интернет обозреватель(Opera, Firefox, Google Chrome, Yandex Browser….) по ссылке вида: https://IP_адрес_сервера_Asterisk/cmp2k/ и выполним базовую настройку созданной нами кастом учетной записи PJsip переходом по кнопке «Account» и заполнением следующих полей:

ID – ID учетной записи PJsip(в рамках данной статьи: guest)
Authorization password — пароль учетной записи PJsip(в рамках данной статьи: guest)
Host IP/Name – IP адрес или доменное имя сервера АТС(в рамках данной статьи генерировался сертификат на доменное имя: meet-voxlink.ddns.net)
Register – снимаем регистрацию с учетной записи
Extension – экстен конференц комнаты

Заполнив все данный учетной записи выполним подключение к серверу АТС нажатием клавиши «Connect» и выполним подключение к конференц комнате нажатием клавиши «Call»