Руководство пользователя SIP-коннектора
Термины и определения
AAC | Многоканальный алгоритм кодирования аудио, поддерживающий потоковую передачу |
AES-128/AES-256 | 128/256-битное аппаратное шифрование по протоколу AES (симметричный алгоритм блочного шифрования) |
API | Программный интерфейс приложения |
Baseline/Main | Профили кодека H.264. Baseline используется для видеоконференций и в мобильных продуктах. Main применяется для цифрового телевидения стандартной четкости в трансляциях, использующих сжатие MPEG-4 |
CPU | Процессор |
H.264 | Стандарт сжатия видео, предназначенный для получения высокой степени сжатия видеопотока при сохранении высокого качества |
HTTP/HTTPS | Протокол прикладного уровня передачи данных и его безопасная версия |
Opus | Аудиокодек для сжатия с потерями для применения в приложениях реального времени в сети |
RAM | Оперативное запоминающее устройство |
SIP | Session Initiation Protocol — протокол установления сеанса. Отвечает за процедуру регистрации пользователя, установление и завершение сеанса связи с соответствующей сигнализацией. Используется в том числе для голосовой связи, обмена документами и медиафайлами. |
Snapd | Приложения со всеми зависимостями для запуска во всех популярных дистрибутивах Linux из одной сборки, обновляющиеся автоматически (подробнее по ссылке) |
SRTP | Безопасный протокол передачи данных в реальном времени, предназначенный для шифрования, установления подлинности сообщения, целостности, защиты от подмены данных |
TCP | Один из основных протоколов передачи данных, предназначенный для управления передачей данных интернета |
TLS/DTLS | Протокол, обеспечивающий защищенную передачу данных между узлами в сети |
UDP | Протокол пользовательских датаграмм, позволяющий приложениям посылать сообщения другим хостам по сети без необходимости предварительного сообщения для установки каналов или путей передачи данных |
URI | Uniform Resource Identifier — унифицированный идентификатор ресурса |
VVoIP | Voice and Video over IP — голосовая и видеосвязь, которая передается в цифровом виде по сетям передачи данных. |
WebRTC | Браузерная технология для передачи потоковых данных между браузерами/приложениями с использованием технологии двухточечной передачи (point-to-point transmission) |
Адрес | Уникальный идентификатор в сети |
ВКС | Видеоконференцсвязь — технология передачи звука и изображения, с помощью которой два и более собеседника могут общаться в режиме реального времени из разных точек |
Домен | Адрес сайта, место его размещения в сети |
ОС | Операционная система |
Порт | Целое неотрицательное число, записываемое в заголовках протоколов транспортного уровня сетевой модели OSI |
Протокол | Совокупность правил и действий для соединения и обмена данными между устройствами в сети |
УПАТС | Учрежденческо-производственная автоматическая телефонная станция |
Введение
Данное руководство описывает технические требования, рекомендуемое оборудование, настройки и работу пользователей с SIP-коннектором программного обеспечения МТС Линк on-premise. В руководстве представлены рекомендации по оптимальным настройкам и работе, а также приведены ответы на часто задаваемые вопросы.
Технические требования
Сетевые параметры
SIP-коннектор ПО МТС Линк on-premise использует различные современные технологии, которые частично или полностью могут быть ограничены в корпоративных сетях в соответствии с принятыми в них сетевыми политиками безопасности.
Все необходимые сетевые настройки описаны в «Руководстве по установке SIP-коннектора ПО МТС Линк on-premise».
Примечание: сервис может некорректно работать при использовании proxy-серверов и других специфических ограничений сети.
Рекомендации по ширине интернет-канала в зависимости от условий использования приведены в таблице:
Условия | Рекомендуемые параметры |
Один спикер | Низкое качество (640x360, 30 кадр./с) — 500 Кбит/с Среднее качество (960x540, 30 кадр./с) — 900 Кбит/с Высокое качество (1280x720, 30 кадр./с) — 1700 Кбит/с |
Три и более спикеров | Каждое из окон требует до 500 Кбит/с и выбрать качество вещания нельзя |
Режим демонстрации экрана | Авто (разрешение зависит от разрешения демонстрируемого контента или экрана, 30 кадров/с) — до 1600 кбит/с |
Оборудование пользователя
Рекомендуемое пользовательское оборудование приведено в таблице:
Устройства | Требования | |
Компьютер | Рекомендуемые параметры | Intel Core i5 6-го поколения или аналогичный CPU 8 Гб RAM Разрешение экрана: 1920×1080 |
Минимальные параметры | Intel Core i3 6-го поколения или аналогичный CPU 4 Гб RAM Разрешение экрана: 1024x768 Важно! Работа сервиса на более слабом клиентском оборудовании не гарантируется и возможна с ограничениями | |
Аудио- и видеоустройства | Наушники или колонки Гарнитура или подключаемый спикерфон с функцией шумо- и эхоподавления Гарнитуры: Microsoft LifeChat LX-3000 Logitech H111 Stereo Headset Logitech H151 Stereo Headset Logitech H540 USB Computer Headset Спикерфоны: Jabra Speak 410 Jabra Speak 510 Jabra Speak 710 Jabra Speak 810 Веб-камеры с микрофоном: Logitech C920 HD Pro Webcam Logitech C922 Pro Stream Webcam Microsoft LifeCam Studio В общем случае для проведения мероприятий достаточно встроенной в систему веб-камеры и микрофона: Apple MacBook/MacBook Pro/iMac/iMac Pro 2015 года и более новые модели | |
Программное обеспечение
В силу технических особенностей работы браузеров рекомендуется использовать их в соответствие таблице:
Поддерживается | Поддерживается с ограничениями | Не поддерживается | |
Google Chrome | ⚫ | ||
Microsoft Edge (Chromium) | ⚫ | ||
Яндекс.Браузер * | ⚫ | ||
Apple Safari | ⚫ | ||
Opera ** | ⚫ | ||
Mozilla Firefox | ⚫ | ||
* Не поддерживаются версии с 23.3.0.2246 по 23.5.2 включительно, так как в них наблюдается сбой со стороны Яндекс.Браузера ** Из-за ограничений в работе декодера H.264 со стороны браузера корректная работа сервиса не гарантируется | |||
Прочие требования
Прочие требования к пользовательскому программному обеспечению приведены в таблице:
Параметр | Требования |
ОС | Windows 8 macOS 10.10 iOS 11 Android 5 ОС семейства Linux последних версий: Ubuntu (через утилиту Snapd). Работа на других Linux-системах, поддерживающих Snapd, возможна, но не гарантируется |
Видео | Кодек H.264 Профили Baseline/Main |
Битрейт не более 2500 Кбит/с При превышении битрейта 2500 Кбит/с, в целях безопасности, передача данных будет автоматически заблокирована | |
Аудио | Кодек AAC Битрейт не более 128 Кбит/с |
Протоколы и кодеки | WebRTC (H.264/Opus) |
Шифрование трафика | Трафик между клиентом и сервером шифруется с использованием TLS, DTLS, SRTP, AES-128, AES-256 |
Защита медиаконтента | Аудио и видео передаются в реальном времени с помощью технологии WebRTC. Эта технология использует протокол защиты транспортного уровня DTLS, который исключает перехват и подделку данных. Для шифрования аудио и видео используется протокол передачи данных Secure Real-Time Protocol (SRTP). Он исключает прослушивание или просмотр голосового и видеотрафика посторонними лицами |
Ограничения | Ограничиваются запросы к пользовательскому API, превышающие 2 запроса в секунду |
Форматы файлов | Изображения: png, jpg, jpeg, bmp, не более 10-и мегапикселей Аудио: mp3, mp4 с кодеком AAC Видео: mp4 с видеокодеком H.264 (Baseline profile) и аудиокодеком AAC (битрейт для видеодорожки — не более 2500 Кбит/с, для аудиодорожки — не более 128 Кбит/с) Документы: doc, docx, xls, xlsx (для таблиц Excel отобразится первый лист книги) Максимальное количество страниц: 500 для документов doc, docx 300 для таблиц xls, xlsx 500 для презентаций ppt, pptx, pdf Примечание: мультимедиа внутри презентаций (аудио, видео, анимация, заметки) не поддерживается |
Размер файлов | Размер видеофайлов не должен превышать 2 Гб. Видео большего размера можно загрузить на видеохостинг Youtube/Vimeo Размер остальных файлов не должен превышать 100 Мб |
Установка ПО
Процесс установки серверной части описан в «Руководстве по установке SIP-коннектора ПО МТС Линк on-premise».
Работа с пользовательской частью осуществляется через поддерживаемые браузеры (см. раздел «Программное обеспечение») или десктопное приложение.
Для полноценного доступа ко всем настройкам личного кабинета, комнаты и мероприятий необходимо использовать поддерживаемые браузеры или десктопное приложение.
Десктопное приложение
Актуальная версия десктопного приложения доступна для скачивания по ссылкам:
для Windows — https://apps.webinar.ru/desktop/latest/webinar-desktop.exe,
для MacOs — https://apps.webinar.ru/desktop/latest/webinar-desktop.dmg,
для Linux — https://apps.webinar.ru/desktop/latest/mts-link-desktop.AppImage.
Важно! Перед началом работы в десктопном приложении необходимо настроить его связь с сервером:
Перед авторизацией в приложении необходимо открыть пункт меню «Файл» - «Рабочее пространство» - «Присоединиться к другому пространству»:
Далее нужно указать название и адрес сервера и нажать на кнопку «Добавить»:
После добавления окно будет закрыто, и произойдет переключение на заданный сервер. Корректность переключения можно проверить повторным открытием меню настройки рабочих пространств.
Для массовой установки приложения внутри Организации можно использовать файл конфигурации рабочих пространств (находится по ссылке: C:\Users\User\AppData\Roaming\MTS Link\config.json). Выбранное рабочее пространство задается параметром «selected workspace host», а все доступные пространства параметром «workspaces»:
Примечание: если в настройках браузера разрешить сайту «https://my.mts-link.ru/» открывать ссылки, используя приложение МТС Линк, то при подключении к мероприятию десктопное приложение будет открываться в фоновом режиме.
SIP-коннектор
Подключение аппаратных ВКС (VVoIP)
Для подключения к онлайн мероприятию с помощью аппаратных SIP-кодеков необходимо:
После создания и настроек мероприятия нажать на «Сохранить». Между данными о мероприятии и его описанием появится кнопка «Данные SIP и телефонии»:
По нажатию на «Данные SIP и телефонии» откроется окно с данными для подключения по SIP URI или по телефону:
Также данные можно получить внутри комнаты. Для этого в правом верхнем меню настроек необходимо нажать на «SIP и телефония»:
Скопированную ссылку нужно ввести на аппаратном терминале или в личном кабинете его программного клиента:
- для устройств Cisco под управлением RoomOS ввод ссылки осуществляется в разделе «Вызов» панели администрирования. Перед подключением можно вручную установить скорость вызова и его тип (аудио/видео):
- для программного клиента Yealink Desktop ввод ссылки осуществляется в разделе вызовов. Перед началом соединения нужно убрать «sip:» в начале ссылки и далее нажать на одну из кнопок вызова (видео или аудио):
Управление параметрами вызова осуществляется после начала соединения:
- для программного клиента Polycom RealPresence Group 310 ввод ссылки осуществляется в разделе «Заказ вызова» панели администрирования в поле «Ручной набор номера». Перед подключением можно вручную установить тип вызова (аудио/видео) и его скорость:
После подключения с помощью аппаратных SIP-кодеков пользователь присоединится к мероприятию в качестве Участника.
Технические особенности и ограничения
1. При настройке SIP-протокола необходимо добавить в исключения порты 5060/TCP, 5061/TCP, 5060/UDP, 3238/UDP, 40000–42000/UDP.
2. Функционал не поддерживается при разделении на групповые комнаты.
3. SIP не поддерживает работу с модулем «Синхронный перевод».
4. Поддерживаемый сигнальный протокол передачи контента: BFCP/UDP
Для приема контента на вашем терминале должна действовать лицензия, поддерживающая разрешение 1080р (для демонстрации экрана, показа презентаций).
5. Поддерживаемый кодек для видео и медиаконтента: H.264.
6. Поддерживаемые кодеки для аудио: G.711, G.722 и Opus, а также G.722.1 и G.722.1C для определенных битрейтов.
7. SIP-клиент должен передавать свой User Agent.
8. В канал медиаконтента не передается рисование и демонстрация видео.
Поддерживаемое оборудование
1. Cisco:
- Cisco Room Kit под управлением RoomOS версии 10.15.3.0 7c44f1ceb87, 10.19.3.0 bb11ddae620.
2. Yealink:
- Yealink VP T-49G;
- Yealink MeetingEye 600, версия ПО 120.320.0.45/120.353.0.45;
- Yealink VC Desktop, версия ПО 1.28.0.72.
3. Polycom:
- Polycom RealPresence Group 310, версия ПО 6.1.5-360613;
- Polycom HDX 700 HD, версия ПО 3.1.11_ne-53024;
- Polycom RealPresence Debut, версия ПО 1.3.2-69919;
- Polycom RealPresence Mobile, версия ПО 3.11.8-6888904;
- Poly Studio X50, версия ПО 4.0.0-376092.
Неподдерживаемое оборудование
Polycom:
- Polycom RealPresence Group 310, версия ПО 6.0.0-280932
- Polycom RealPresence Group 700, версии ПО 6.2.2.8-670021 и 6.1.4-400053
Если используемого оборудования нет среди вышеперечисленного, необходимо обратиться к персональному менеджеру или в службу технической поддержки для организации тестирования интересующих моделей.
Виджет для ВКС терминалов под управлением Cisco RoomOS
Данный виджет реализует кнопку на стартовой панели планшета управления ВКС терминала Cisco Room Kit и позволяет присоединяться к мероприятиям путем ввода короткого значения ID мероприятия.
Установка виджета
Важно! Для установки потребуется наличие двух файлов: файла конфигурации «link-button.xml» и файла скрипта «link-script.js».
Для их получения необходимо обратиться к персональному менеджеру или в службу технической поддержки.
Для настройки виджета необходимо:
1. В личном кабинете панели администрирования Cisco открыть раздел «Редактор расширений пользовательского интерфейса»:
2. Далее открыть «Меню редактора» в правом верхнем углу окна и нажать на «Объединить из файла», а затем выбрать и загрузить файл конфигурации «link-button.xml»:
3. После загрузки файла конфигурации нажать на кнопку «Экспорт конфигурации в видеосистему»:
4. Далее нужно вернуться в основное окно панели администрирования и перейти в раздел «Редактор макросов»:
5. В левом верхнем углу этого раздела нажать на «Импорт из файла», выбрать и загрузить файл скрипта «link-script.js». После этого нажать на кнопку «Сохранить в видеосистему» справа от скрипта:
После этого справа от скрипта появится переключатель, с помощью которого можно включать или выключать скрипт.
В результате установки на стартовой панели планшета управления появится кнопка «МТС Линк»:
При нажатии на кнопку будет открываться окно для ввода ID мероприятия — десяти цифр из полной ссылки URI (например, если полная ссылка имеет вид «sip:1122334455@dev-sip.webinar.ru», то ID мероприятия — 1122334455).
При вводе корректного ID будет совершен звонок с последующим подключением к мероприятию. В случае ввода некорректного ID появится сообщение об ошибке.
Полную ссылку URI можно получить внутри настроек комнаты (см. раздел «Подключение аппаратных ВКС (VVoIP)»).
Исходящий вызов на аппаратные ВКС (VVoIP)
При подключенном функционале исходящих звонков на аппаратные терминалы у администратора Организации в разделе «Бизнес» личного кабинета появится подраздел «Мои устройства». Сюда можно добавлять адреса устройств, чтобы быстро звонить на них из мероприятий:
Для совершения звонка из мероприятия на терминал ВКС необходимо:
1. Во время проведения мероприятия нажать на кнопку приглашения участников и выбрать «Мои устройства»:
2. Далее выбрать устройство из ранее сохраненных или ввести SIP URI, после чего нажать на кнопку «Пригласить»:
Начнется дозвон, и ВКС терминал присоединится к мероприятию в качестве Участника.
Если дозвониться не получилось, можно попробовать позвонить еще раз, нажав на одну из кнопок в правой или нижней части окна комнаты:
Также нужно проверить корректность введенного SIP URI, позвонить еще раз (вызываемый терминал может быть занят или выключен) или обратиться в службу технической поддержки.
Подключение к мероприятиям по телефону
В рамках данного способа интеграции можно совершать звонки на онлайн мероприятия с помощью корпоративной АТС (УПАТС).
Важно! На УПАТС необходимо настроить правила таким образом, чтобы звонки с выбранного номера перенаправлялись на sip:0000@sip.webinar.ru.
Подробную информацию о настройке необходимо узнать у администратора используемой УПАТС.
Для совершения звонка на мероприятие необходимо:
1. Перейти в раздел «Организация» на вкладку «Телефония» и выбрать «SIP-Trunk» в качестве способа интеграции. Ниже появится поле «Информация для пользователей», в которое ввести данные о том, куда и как звонить. Эти данные будут использованы в интерфейсе платформы и в письмах, которые получает пользователь. После ввода данных нажать на «Сохранить»:
2. Данные для подключения с помощью SIP-кодеков и телефонов при планировании мероприятия станут доступны из ее настроек после сохранения:
3. После нажатия на «Данные SIP и телефонии» откроется окно с данными для подключения. В поле «Подключение по телефону» будут отображаться варианты дозвона, заданные на этапе выбора способа интеграции:
Также данные можно получить внутри комнаты. Для этого в правом верхнем меню настроек необходимо нажать на «SIP и телефония».
4. Для подключения к мероприятию нужно позвонить по номеру телефона и в тональном режиме ввести идентификатор мероприятия и решетку.
Подключенный к мероприятию сможет слышать Участников, а они будут слышать его:
В случае, если идентификатор мероприятия устарел или был введен с ошибками, автомат сообщит о том, что мероприятие не найдено. После этого можно будет осуществить повторный ввод идентификатора конференции.