Клиент для sip2go

# SIP2GO

SIP2GO — это Android-клиент для шлюза SIP2GO, то есть сервера с открытым исходным кодом, который вы разворачиваете на собственной инфраструктуре.

⚠️ **ЭТО ПРИЛОЖЕНИЕ НЕ РАБОТАЕТ САМОСТОЯТЕЛЬНО**

SIP2GO не является публичным VoIP-сервисом и не является обычным SIP-софтфоном. Приложение само по себе не предоставляет телефонные номера, SIP-аккаунты или облачную телефонию.

Перед использованием приложения необходимо установить и запустить сервер SIP2GO (шлюз) и подключить его к любой доступной АТС по протоколу SIP.

Если у вас нет сервера SIP2GO, приложение работать не будет.

━━━━━━━━━━━━━━━━━━━━
**КАК ЭТО РАБОТАЕТ**
━━━━━━━━━━━━━━━━━━━━

Вы размещаете сервер → настраиваете Asterisk → регистрируете этот телефон как внутренний номер.

**Asterisk / IP-АТС ←→ SIP2GO gateway (ваш сервер) ←→ это Android-приложение**

Шлюз регистрируется на вашей IP-АТС как обычный SIP-терминал. Приложение подключается к вашему шлюзу через зашифрованный WebSocket (TLS) и передаёт голос с использованием кодека Opus.

SIP-стек непосредственно на телефоне не используется. Основная работа выполняется на вашем сервере.

━━━━━━━━━━━━━━━━━━━━
**ЧТО НЕОБХОДИМО ДЛЯ РАЗВЁРТЫВАНИЯ**
━━━━━━━━━━━━━━━━━━━━

• **SIP2GO gateway** — серверный компонент с открытым исходным кодом на Python, размещаемый вами самостоятельно
• **Asterisk** или совместимая SIP/IP-АТС в вашей локальной сети или дата-центре
• **Публичный HTTPS-адрес** шлюза для работы WebSocket и push-уведомлений
• ** Для работы Push режима, получить доступ к централизованному Push Relay** — сервис для централизованной отправки FCM push-уведомлений. В виду невозможности изменить ключ от Firebase в приложении, мы были вынуждены сделать эту часть сервиса проприетарной.

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

━━━━━━━━━━━━━━━━━━━━
**ВОЗМОЖНОСТИ ПРИ НАЛИЧИИ ВАШЕГО СЕРВЕРА**
━━━━━━━━━━━━━━━━━━━━

### Входящие вызовы

• Экономичный режим — постоянное соединение не требуется
• Надёжное пробуждение приложения при входящем вызове через Firebase push-уведомления
• Полноэкранный интерфейс входящего вызова и отображение на экране блокировки

### Исходящие вызовы

• Постоянное подключение и звонки на внутренние номера IP-АТС или внешние номера
• Встроенная цифровая клавиатура, повторный набор и DTMF для работы с IVR

### Во время звонка

• Отключение микрофона, громкая связь, разговорный динамик, проводная гарнитура и Bluetooth
• Удержание и возобновление вызова
• Слепой перевод вызова
• Необязательная локальная запись разговоров
• История вызовов и уведомления о пропущенных звонках

### Дополнительные возможности

• Настройка устройства с помощью QR-кода
• Брендирование приложения с сервера вашей организации
• Интерфейс на английском и русском языках
• Необязательная интеграция с Android Telecom и системным интерфейсом вызовов

━━━━━━━━━━━━━━━━━━━━
**СИСТЕМНЫЕ ТРЕБОВАНИЯ**
━━━━━━━━━━━━━━━━━━━━

• Собственный развернутый сервер SIP2GO — **обязательно**
• Android 8.0 или новее
• Доступ в интернет к URL вашего шлюза
• Сервисы Google Play для push-уведомлений
• Разрешение на использование микрофона

━━━━━━━━━━━━━━━━━━━━
**ДЛЯ КОГО ПРЕДНАЗНАЧЕНО ЭТО ПРИЛОЖЕНИЕ?**
━━━━━━━━━━━━━━━━━━━━

Для IT-команд, интеграторов и компаний, которые самостоятельно управляют собственной телефонной инфраструктурой и хотят подключить Android-устройства в качестве защищённых внутренних номеров через шлюз, полностью находящийся под их контролем.

Это **не потребительское VoIP-приложение** из Google Play и не самостоятельный сервис телефонии.

**Исходный код сервера и документация:** предоставляются в рамках вашей установки SIP2GO или поставщиком решения. Информацию о серверной части вы можете найти на сайте s2g.uz

**Не устанавливайте это приложение, если у вас уже нет или вы не планируете самостоятельно разворачивать серверный компонент SIP2GO.**