Темы



Web Sip клиент на основе JsSIP + FreePBX21.06.2020 20:32

У FreePBX есть Web Sip клиент. Мне было интересно как он работает. Начав изучать технологию WebRTC я наткнулся на 3 библиотеки — это JsSIP, его fork SIP.js, а также sipml5.

JsSIP и SIP.js не удалось запустить с первого раза, не хватало опыта. А вот sipml5 оказался самым простым в применении. Скачав его тестовую версию, получилось совершить первый звонок.

Все 3 библиотеки работоспособны. У каждой есть свои сильные и слабые стороны. Протестировав все 3 библиотеки, остановил выбор на JsSIP.
Основные плюсы и минусы с которыми я столкнулся:

1. JsSIP

Плюсы:

  • легковесная;
  • активно поддерживается разработчиками.


Минусы:

  • на начальном этапе более сложная для старта;
  • пришлось править исходники чтобы заработал с asterisk.


2. Sip.js

Плюсы:

  • легковесная;
  • упор делается для работы с asterisk.


Минусы:

  • не удалось запустить звук для Early media (не подключается звук для предответных сообщении оператора).


3. Sipml5

Плюсы:

  • относительно простая для новичков.


Минусы:

  • сложный и запутанный код, не было желания разбираться в нем.


Подготовка


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

Firefox разрешает работать с самоподписанными сертификатами. Для работы в Хроме придется делать сначала корневой сертификат, а на его основе уже подписывать сертификат для работы телефона. Корневой сертификат должен быть импортирован в хранилище сертификатов.

Включение поддержки web sip клиента на FreePBX


Администратор → User Managment → Вкладка «Groups» → Вкладка «UCP» → Вкладка «Phone»
Для свойства «Enable Phone» выбираем значение «Да».

Если у вас в FreePBX были внутренние номера, допустим 200, то при активации web sip клиента появятся дополнительные номера с префиксом 99, т.е. 99200.

На клиентском браузере, после того как дали разрешение на использование самоподписанного сертификата, нужно еще дать разрешение для сертификата asterisk. Для этого наберите в браузере 

https://192.168.1.70:8089/ws


IP-адрес нужно указать тот, на котором запущен asterisk.

Правка исходника JsSIP


В исходниках библиотеки JsSIP необходимо заменить transport=ws на transport=wss. Без этой правки клиент не заработает. В Sip.js править ничего не нужно, там этот момент предусмотрели.

Код web sip клиента на основе JsSIP


Для демонстрации работы клиента скопируйте нижеприведенный код, сохраните и запустите страницу. Страница демонстрирует исходящий звонок. Код 100% рабочий, проверил прежде чем выложить.





<script type="text/javascript" src="/lib/jquery-3.4.1.js"></script>
<script type="text/javascript" src="/lib/jsSIP/jssip.min.js"></script>





  
Web Sip клиент на основе JsSIP

  

    
  

  
Вызов

  
Завершить















<script>
JsSIP.debug.enable('JsSIP:*');
var socket = new JsSIP.WebSocketInterface('wss://192.168.1.70:8089/ws');
var configuration = {
	sockets  : [ socket ],
	// внутренний номер	
	uri      : '99XXX@192.168.1.70',
	// пароль
	password : 'passw'
};

var remoteAudio = new window.Audio();
remoteAudio.autoplay = true;

var ua = new JsSIP.UA(configuration);

// События регистрации клиента
ua.on('connected', function(e) { /* Ваш код */ });
ua.on('disconnected', function(e) { /* Ваш код */ });

ua.on('registered', function(e) { /* Ваш код */ });
ua.on('unregistered', function(e) { /* Ваш код */ });
ua.on('registrationFailed', function(e) { /* Ваш код */ });

// Запускаем 
ua.start();

// Обработка событии исх. звонка
var eventHandlers = {
	'progress': function(e) {
		console.log('call is in progress');

		session.connection.ontrack = function(e) {
			console.log(e);
			remoteAudio.srcObject = e.streams[0];
		};
	},
	'failed': function(e) {
		console.log('call failed with cause: ' + e.cause);
		$('#call').css({'display' : 'flex'});
		$('#hangup').css({'display' : 'none'});
	},
	'ended': function(e) {
		console.log('call ended with cause: ' + e.cause);
		$('#call').css({'display' : 'flex'});
		$('#hangup').css({'display' : 'none'});
	},
	'confirmed': function(e) {
		console.log('call confirmed');
		console.log(e);
	}
};

var options = {
	'eventHandlers'    : eventHandlers,
	'mediaConstraints' : { 'audio': true, 'video': false }
};

// Кнопка для звонка
$('#call').click(function(e) {
	session = ua.call($('#num').val(), options);
	$('#call').css({'display' : 'none'});
	$('#hangup').css({'display' : 'flex'});
});

// Кнопка для отбоя звонка
$('#hangup').click(function() {
	if (session) {
		session.terminate();
	}

	$('#call').css({'display' : 'flex'});
	$('#hangup').css({'display' : 'none'});
});
</script>


Должна получиться такая страница:

yxbavc0zohj7_nyfpx4ihbx1vi8.png

Теперь можно пробовать совершить первый звонок. Если все сделали правильно, то услышите гудок, при ответе должен пойти звук в обе стороны. Начинаем полноценную беседу.

Итоги


За последние 2 года использования Web sip клиента были проблемы, которые появлялись при обновлении браузера.

Например в 63 версии Firefox пришлось менять SDP протокол, чтобы сессия не отбивалась. Браузер перестал держать связь без параметра a=mid:0. В последних версиях уже не актуально, ошибку исправили, в более поздних версиях уже нет такой проблемы.

В 65 версии Firefox при исх. звонке начал пропадать голос собеседника, в локалке не было таких проблем. Проблема только при вызове наружу через шлюз. В хроме такой проблемы не наблюдалось, все работает стабильно.

В основном пользователи работают в Firefox, и по этой причине пришлось в библиотеке убрать повторное согласование SDP протокола. Проблемы с пропаданием звука после ответа перестали беспокоить.

Перспективы


В данный момент на js была написана программа «Автообзвон», которая способна по первым нескольким секундам распознавать предответные сообщения оператора такие как: тел. не существует, абон. занят, тел. отключен, тел. доступен. Точность распознавания 95% и выше. Если будет время, напишу статью и опишу алгоритм.

© Habrahabr.ru