Материал из for iRidium developers
Перейти к: навигация, поиск
Эта страница является переводом страницы SIP-telephony. Перевод выполнен на 100%.

Other languages:

iRidium для SIP телефонии

набор инструментов для создания интерфейсов, позволяющих совершать аудио и видео-вызовы между приложениями-клиентами iRidium (i3 pro), IP-телефонами и видео-домофонами с поддержкой стандарта SIP

документация обновлена 27.6.2017

IRidiumSipPicture.png

Готовые интерфейсы для работы i3 pro как SIP интеркома / панели домофона:

проект, устройство функции
интерком (смартфон)
интерком (планшет, ПК)
  • клавиатура для вызовов
  • аудио- и видео-вызовы
  • прием вызовов
  • "черный список" абонентов
  • история вызовов
  • настройка сервера
  • настройка аудио-фильтров
упрощенный интерком (смартфон)
упрощенный интерком (планшет, ПК)
  • клавиатура для вызовов
  • аудио-вызовы
  • прием вызовов
  • "черный список" абонентов
  • настройка аудио-фильтров
панель домофона (смартфон)
панель домофона (планшет, ПК)
  • кнопка вызова домофона
  • прием вызова от домофона
  • видео с камеры (если есть)
  • можно добавить интерком
панель домофона Mobotix (смартфон)
панель домофона Mobotix (планшет, ПК)
  • кнопка вызова домофона
  • прием вызова от домофона
  • риал тайм видео с камеры
  • открытие двери
  • переключение света
  • можно добавить интерком


Лицензирование:

  • используйте бесплатно в тестовом режиме i3 pro (через iRidium Transfer)
  • приобретите лицензию iRidium 3.x, дополнение "SIP-телефония" предоставляется бесплатно


Описание

iRidium для SIP телефонии - это набор инструментов, позволяющий создать интерфейс вызывной панели, работающий по протоколу SIP. i3 pro может совершать и принимать аудио и видео-вызовы от других вызывных панелей.

Драйвер может быть использован на iRidium server только для реализации PUSH уведомлений

Для совершения вызова, требуется настроенный SIP сервер (иначе называется PBX сервер или IP-АТС), коммутирующий звонки между вызывными панелями. iRidium не предоставляет готового SIP сервера, поэтому необходимо использовать готовое решение, например:

  • linphone (linphone.org) - бесплатный SIP сервер в интернете, необходима регистрация
  • 3cx (Windows) - для установки на ПК
  • AsteriskNow (Linux, Windows) - для установки на ПК или аппаратное решение
  • FreePBX (Linux) - для установки на ПК
  • Elastix (Linux) - для установки на ПК
  • Mobotix - SIP сервер, встроенный в вызывную панель IP-домофона Mobotix T24, T25
  • Helios
  • Yeastar


Рекомендованные домофоны - вызывные панели, можно подключить к SIP серверам как абонентов, для совершения аудио и видео вызовов:

  • Mobotix T24, T25 (аудио и видео)
  • GUINAZ (аудио, поддержка видео H264 в iRidium появится позже)
  • 2N (аудио и видео)
  • BAS-IP (аудио и видео)
  • True-IP (аудио и видео)


Поддерживаются кодеки (остальные желательно отключить в настройках SIP сервера):

  • PCMU (M-Law)
  • PCMA (A-Law)
  • GSM
  • H263
  • H263-1998


Не поддерживается работа в фоновом режиме (получение вызова свернутым и закрытым приложением).


Подключение

Конфигурация оборудования и настройки, необходимые для того, чтобы iRidium подключился к SIP серверу и мог совершать звонки.

SIP сервер - может быть аппаратным или программным. Функция сервера - коммутация вызовов между подключенными к нему абонентами.

SIP абонент - это iRidium на смартфоне, планшете или ПК, IP-телефон, видео-домофон. Абоненты могут вызывать друг друга только через сервер.


Настройка SIP сервера

SIP сервер (PBX сервер) хранит список абонентов, которые могут вызывать друг друга, и делает возможным вызов абонента. Голосовую связь через SIP сервер можно настроить между панелями iRidium, аппаратными и программными IP-телефонами, видео-домофонами, в квартире, доме или офисе.

SIPstruct.png


Выберите подходящий SIP сервер и настройте на нем несколько абонентов. Каждый абонент - это вызывная панель или домофон.

Инструкции по настройке серверов:

  • SIP сервер 3CX PhoneSystem
  • SIP сервер Mobotix T24 / T25
  • SIP сервер linphone.org (sip.linphone.org): создайте аккаунты на сайте - каждый аккаунт имеет логин, который вы должны использовать в качестве номера абонента. Адрес сервера: sip.linphone.org


О настройке других SIP серверов читайте на сайтах производителей.


Настройка вызывной панели

Скачайте интерфейс вызывной панели и настройте его в iRidium Studio для подключения к SIP серверу.

1. В Project Device Panel, драйвер SIP, укажите параметры SIP сервера и номер абонента, которым будет панель iRidium.

SIP DriverSettings.png
  • Name - имя драйвера, НЕ меняйте в готовом интерфейсе
  • Driver Type - информация о типе драйвера
  • Host - IP-адрес или домен SIP сервера
  • Port - порт подключения к SIP серверу. Обычно 5060, а для Mobotix T24/T25: 5061
  • Password - пароль подключения абонента к SIP серверу
  • Caller ID (Name) - имя абонента (может совпадать с SIP номером)
  • SIP ID (Number) - SIP номер абонента
  • First RTP Port - начало диапазона портов голосового обмена. Обычно 40000, а для Mobotix T24/T25: 7078
  • Last RTP Port - конец диапазона портов голосового обмена. Обычно 41000, а для Mobotix T24/T25: 9078. Пробросьте эти UDP порты на роутере при звонках через интернет
  • Use SIP TONE - генерировать SIP сообщения тонального набора
  • Use DTMF TONE - генерировать обычные сообщения тонального набора. Они передаются в голосовом потоке. Рекомендованы к использованию
  • Extrenal IP - внеший IP адрес панели управления. Указывается только, если в поле Host - адрес удаленного SIP сервера. Чтобы заполнять это поле автоматически при звонках через интернет, используйте инструкцию
  • Codec PCMU, Codec PCMA, Codec GSM, Codec G722 - аудио-кодеки SIP. Можно включить 1 или все аудио-кодеки. Если не уверены, какой кодек поддерживает вызываемая сторона, включите все - кодек будет выбран автоматически. Выключать все аудио-кодеки нельзя
  • Codec H263, Codec H263-1998 - видео-кодеки SIP. Можно включить 1 или оба видео-кодека. Если включены оба, кодек будет выбран при видео-вызове автоматически
  • Корректировка звука. Переключить режимы корректировки следует во время вызова. Некоторые режимы включаются с помощью команд драйвера SIP (см. готовые проекты). Включать корректировку или нет - зависит от условий работы:
    • Echo Cancellation - подавление эхо
    • Volume Control - автоматическая корректировка громкости
    • Noise Suppression - подавление шума во время разговора
  • Use Decline - отправлять команду DECLINE вместе с CANCEL при завершении вызова (требуется для корректного завершения вызова при работе с некоторыми SIP серверами, например 2N)


2. Статус вызывной панели при успешном подключении к серверу: On Hook... (SIP > Feedback > STATUS)

3. Чтобы использовать вызывную панель без изменений, загрузите проект на панель управления.

4. Чтобы добавить вызывную панель в свой, готовый проект, следуйте инструкции в видео.


Команды и сообщения драйвера SIP

Готовые интерфейсы вызывных панелей используют команды и сообщения драйвера SIP для совершения и принятия вызовов. Обработку вызова выполняет JavaScript файл, без которого визуальный интерфейс не будет работать корректно.

Список команд и каналов обратной связи драйвера SIP которые вы можете использовать при модификации JavaScript обработчиков и напрямую, привязывая команды и каналы к графическим элементам:

SIP drivercommands.png

Commands:

  • ANSWER - ответить на входящий звонок. Привяжите команду к кнопке:
    • Send Number: 0 - ответить с аудио-вызовом
    • Send Number: 1 - ответить с видео-вызовом
  • CALL - позвонить. Номер, куда будет совершен вызов, нужно заранее записать в Feedbacks > NUMBER, как строку. Привяжите команду к кнопке:
    • Send Number: 0 - аудио-вызов
    • Send Number: 1 - видео-вызов
  • CANCEL - отмена вызова. Привяжите команду к кнопке, Send Number: 0
  • SEND TONE - отправить тоновое значение. Привяжите команду к кнопке, Send Number: 1-9; * = 10; # = 11
  • REGISTER - зарегистрироваться на SIP сервере. Привяжите команду к кнопке, Send Number: 0
  • UNREGISTER - отключиться от SIP сервера. Привяжите команду к кнопке, Send Number: 0
  • SET AUDIO VOLUME - громкость динамиков (0-100%)
  • SET ECHO CANCELATION - эхоподавление, вкл/выкл (1/0)
  • SET MIC VOLUME - громкость микрофона (0-100%)
  • SET NOIZE SUPR - шумоподавление, вкл/выкл (1/0)
  • SET SPEECH SEND - активация голосом: отправлять звук только при наличии речи, иначе тишина, вкл/выкл (1/0). Работает только при включенном SET VOLUME CONTROL
  • SET VOLUME CONTROL - эхозаграждение: понижать громкость микрофона и динамиков при разговоре. Без него не работает SET SPEECH SEND


Feedback:

  • AUDIO VOLUME - громкость динамиков (0-100%)
  • CODEC - тип данных звука и видео: Payload Type (PT) см. полный список
  • ECHO CANCELATION - эхоподавление, вкл/выкл (1/0)
  • FIRST RTP PORT - первый порт RTP диапазона
  • INCOMING CALL - есть ли входящий звонок? 0 - нет, 1 - есть
  • INCOMING CALL NAME - имя звонящего, текст
  • INCOMING CALL NUMBER - номер звонящего, текст
  • JITTER - (мс) качество связи, дрожание канала. Скачущие значения более 30 мс могут быть признаком нестабильной связи
  • LAST RTP PORT - последний порт RTP диапазона
  • MIC VOLUME - громкость микрофона (0-100%)
  • NOIZE SUPR - шумоподавление, вкл/выкл (1/0)
  • NUMBER - номер абонента. В этот Feedback записывают значение через диалог "Send to Project Token > Send Number" в редакторе макросов, чтобы при вызове команды CALL позвонить указанному абоненту
  • STATUS - текущий статус соединения (в текстовом виде):
    • On Hook... - подключен к SIP серверу, готов к работе
    • Connected... - создал подключение, готовлюсь к регистрации
    • Disconnected... - принудительно отключен от сервера (командой драйверу)
    • Failed... - ошибка создания подключения (не связана с SIP сервером)
    • Trying... запрос вызова обрабатывается
    • Ringing... - местоположение вызываемого пользователя определено. Выдан сигнал о входящем вызове
    • Incoming Call... - входящий вызов
    • Talking... - разговор
    • Not Found... - вызываемый абонент не найден, нет такого SIP-номера
    • Not Acceptable... - соединение с сервером было установлено, но отдельные параметры, такие как тип запрашиваемой информации, полоса пропускания, вид адресации не доступны
    • Not Available... - вызываемый абонент не доступен для вызова
    • Declined... вызываемый пользователь не желает принимать входящие вызовы, не указывая причину отказа
    • Request Pending... - запрос поступил в то время, когда сервер еще не закончил обработку другого запроса, относящегося к тому же диалогу
    • Service Unavailable... - сервер не может в данный момент обслужить вызов вследствие перегрузки или проведения технического обслуживания



Эмулятор: проверка проекта

Эмулятор (Emulator) - приложение для проверки работы проекта в редакторе iRidium Studio.

Эмулятор работает только после авторизации с использованием логина и пароля с сайта iRidium Mobile

Режимы работы Эмулятора настраиваем в Tools > Options > Emulator:

  • Client Fullscreen - запуск в полноэкранном режиме
  • Client Sound On - включить/выключить звук в приложении
  • Show log at Emuator Start - автоматически открывать окно лога (иначе лог можно открыть по нажатию F4)


Path to the license.png

Горячие клавиши:

  • F4 - открыть лог
  • F5 - запустить Эмулятор
  • F7 - открыть меню управления аккаунтом и проектами
  • F8 - открыть системные настройки (введите пароль 2007)



Синхронизация с панелью управления

Если вы - интегратор, вы можете быстро запустить созданный интерфейс визуализации на панели управления - смартфоне, планшете или ПК. Установите приложение i3 pro и авторизуйтесь в нем с помощью вашего логина и пароля интегратора с сайта iRidium Mobile.


Используйте i3 pro для iOS, Android, Windows, Mac в тестовом режиме, загружая проекты через iRidium Transfer (возможность доступна только для интеграторов):


Настройки iRidium Transfer


Коммерческое использование iRidium возможно толкьо при загрузке проектов визуализации с помощью облачного сервиса iRidium Cloud на сайте iRidium Mobile (см. инструкцию).

iRidium Cloud может настроить только зарегистрированный интегратор. После настройки, доступно приглашение пользователей к управлению объектом автоматизации.