PTT Voice — описание, помощь и документация

Полное руководство пользователя

Интернет-рация, каналы, сканирование, SVXReflector, чат, приватная связь и настройки звука

Дата редакции: 16 июля 2026 года

Android 5–16 • смартфоны и специализированные PoC-терминалы

Как пользоваться этим руководством

Документ построен от простого к сложному. Новому пользователю достаточно прочитать разделы «Быстрый старт», «Интерфейс смартфона», «Каналы» и «Как говорить по PTT». Владельцам SVX-доступа нужен отдельный большой раздел про SVX-комнаты. Все настройки перечислены в конце с назначением, диапазонами и практическими рекомендациями.

Содержание

• 1. Что такое PTT Voice
• 2. Для кого предназначено приложение
• 3. Возможности и преимущества
• 4. Как устроена связь и защита данных
• 5. Установка и первый запуск
• 6. Регистрация и вход
• 7. Быстрый старт
• 8. Интерфейс смартфона
• 9. Каналы и доступ
• 10. Общий сканер каналов
• 11. Передача и приём голоса
• 12. Пользователи, карточки и приватная связь
• 13. Чат канала
• 14. SVX-комнаты и SVXReflector
• 15. Полный разбор настроек
• 16. PRO-функции и VOX
• 17. PoC-терминалы
• 18. Фоновая работа, резервирование и обновления
• 19. Рекомендуемые профили настройки
• 20. Решение проблем
• 21. Частые вопросы
• 22. Глоссарий
• Приложение A. Диапазоны и значения настроек
• Приложение B. Краткие памятки

1. Что такое PTT Voice

PTT Voice — это приложение интернет-рации. Оно превращает Android-смартфон или специализированный PoC-терминал в рацию с каналами: пользователь выбирает комнату, удерживает кнопку PTT, говорит и отпускает кнопку для перехода на приём.

Приложение сочетает классическую логику Push-to-Talk с современными возможностями: списком комнат, сканированием, аватарами и карточками говорящих, текстовым и медиа-чатом, приватными вызовами, тонкой обработкой звука и интеграцией с SVXLink/SVXReflector.

PTT Voice рассчитан не только на короткие голосовые переговоры. Это единая среда для постоянного дежурства в каналах, общения радиолюбителей, работы групп и сообществ, использования аппаратной PTT-кнопки, подключения к радиосетям через SVX и обмена материалами в чате.

Рисунок 1. Пользовательская схема связи PTT Voice.

1.1. Основные понятия

2. Для кого предназначено приложение

• радиолюбители, радиоклубы и владельцы SVXLink-узлов;
• локальные и региональные группы оперативного голосового общения;
• службы, волонтёрские команды, технические и выездные бригады;
• сообщества, которым нужны постоянные комнаты вместо одноразовых звонков;
• владельцы кнопочных PoC-терминалов, Hytera/Meig-подобных устройств и смартфонов с внешней PTT-кнопкой;
• пользователи, которым важны общий сканер каналов, аппаратная кнопка и фоновой режим;
• группы, совмещающие голос, текстовый чат, файлы, изображения, видео, GIF и стикеры.

2.1. Типовые сценарии

3. Возможности и преимущества

3.1. Что умеет PTT Voice

• голосовые комнаты с радиоподобной логикой PTT;
• работа через современный транспорт PTT Voice 2: UDP, Opus и шифрование аудиопакетов AES-GCM;
• автоматическое восстановление соединения после кратких сетевых перебоев и смены Wi-Fi/LTE;
• фоновый сервис с постоянным системным уведомлением и восстановлением после перезагрузки или обновления приложения;
• основной и резервный серверы для повышения отказоустойчивости;
• автоматический или ручной битрейт Opus;
• настраиваемые микрофон, усиление, АРУ, шумодав, лимитеры, джиттер-буфер и буфер начала передачи;
• эквалайзер, реверберация, изменитель голоса и VOX как управляемые PRO-функции;
• общий сканер выбранных комнат, включая несколько SVX-комнат;
• персональные SVX Login, основная TG, Monitor TG, временный переход к нодам и избранное;
• центральная RX-карточка с аватаром и именем говорящего;
• полноценный чат с ответами, реакциями, файлами, изображениями, видео, аудио, ссылками, стикерами и GIF;
• приватные PTT-вызовы с автоматическим возвратом в исходную комнату;
• интерфейсы для смартфона, сенсорного PoC и кнопочного PoC;
• назначение аппаратной PTT-кнопки, поддержка vendor broadcast и Bluetooth-гарнитуры;
• встроенная проверка обновлений и просмотр истории «Что нового».

3.2. Чем приложение отличается от типичных аналогов

4. Как устроена связь и защита данных

Управление и голос передаются разными путями. Авторизация, список комнат, права, состояние говорящего и служебные команды идут через защищённое WebSocket/TLS-соединение. Голос кодируется Opus и передаётся отдельными UDP-пакетами.

Аудиополезная нагрузка защищается AES-GCM с ключом конкретной комнаты. Сервер видит служебный заголовок, проверяет пользователя и активного говорящего, затем маршрутизирует пакеты слушателям. Серверный аудиомаршрутизатор не декодирует Opus и не воспроизводит звук.

• 48 кГц, один канал, кадры по 20 мс;
• битрейт 16, 24, 32, 48 или 64 кбит/с, а также автоматические режимы;
• отдельная конфигурация и ключ для каждой комнаты;
• приватная связь создаёт отдельную временную runtime-комнату со своим ключом;
• старые WebRTC/P2P/TURN-маршруты не используются как рабочий голосовой транспорт;
• TLS на Android 5–6 реализован отдельным совместимым путём, но без отключения проверки сертификата.

5. Установка и первый запуск

5.1. Совместимость

• Android 5.0 и новее; проект рассчитан на работу вплоть до Android 16;
• смартфоны, сенсорные мини-PoC и кнопочные PoC-терминалы;
• минимум: доступ в Интернет и рабочий микрофон;
• для комфортной фоновой работы рекомендуется разрешить уведомления и исключить приложение из оптимизации батареи.

5.2. Установка APK

1. Скачайте APK из доверенного источника PTT Voice.
2. Откройте файл. На Android 8 и новее система может попросить разрешить установку приложений из этого источника.
3. Подтвердите установку или обновление поверх существующей версии.
4. Запустите PTT Voice и разрешите необходимые системные запросы.

5.3. Разрешения

6. Регистрация и вход

6.1. Обычная регистрация

1. На стартовом экране введите новый логин и пароль.
2. Нажмите «Регистрация».
3. После успешного создания аккаунта войдите теми же данными.
4. Сохранённая сессия позволяет приложению восстанавливать вход после перезапуска и переподключения.

Требования текущего клиента: логин длиной 5–15 символов, без пробелов; допустимы кириллица, латиница, цифры, «-», «_», «.» и не более двух emoji. Пароль — 5–30 символов, без пробелов и управляющих символов.

6.2. Вход через Google

1. Дождитесь подключения к серверу. Кнопка «Продолжить через Google» появляется только после получения серверной конфигурации Google-входа.
2. Нажмите кнопку и выберите Google-аккаунт.
3. Если аккаунт уже привязан — вход произойдёт автоматически.
4. Если это первый вход, приложение предложит создать логин PTT Voice. Пароль для самого Google-входа не требуется.

6.3. Пароль для аккаунта, созданного через Google

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

6.4. Выход из приложения

Пункт «Выход» в главном меню — это явное завершение пользовательской сессии и фонового сервиса. Простое сворачивание приложения не является выходом: интернет-рация продолжает работать в фоне.

7. Быстрый старт

1. Установите приложение и выдайте разрешение на микрофон и уведомления.
2. Зарегистрируйтесь или войдите в существующий аккаунт.
3. На экране «Все каналы» нажмите нужную комнату.
4. Если канал защищён паролем — введите пароль. Если он закрыт по списку пользователей — получите доступ у администратора.
5. Дождитесь отображения комнаты и списка участников.
6. Удерживайте кнопку PTT, дождитесь разрешения TX и говорите. Отпустите кнопку для перехода на приём.
7. Проверьте уровень микрофона. Если начало слов пропадает — увеличьте «Буфер начала передачи» или после осознанного предупреждения включите «Разогрев микрофона».
8. Для фоновой работы исключите приложение из оптимизации батареи.

8. Интерфейс смартфона

8.1. Верхняя панель

Отключённая кнопка микрофона или динамика заметно анимируется. Состояние этих двух кнопок временное и при новом запуске приложение начинает с включённым микрофоном и динамиком.

8.2. Экран «Все каналы»

• обычный тап по комнате — начать вход;
• долгое нажатие — открыть действия «Сканировать» и «О канале»;
• выбранные для сканирования комнаты отмечаются отдельно;
• после периода бездействия на списке комнат запускается сканер, если выбрана хотя бы одна доступная комната;
• во время активного scan focus отображается центральная карточка с названием канала и говорящим.

8.3. Экран комнаты

8.4. Жесты

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

9. Каналы и доступ

9.1. Виды доступа

9.2. Ручной вход

Ручной вход всегда имеет приоритет над сканером. Как только пользователь начинает открывать комнату или окно её пароля, клиент снимает scanner и не включает его повторно, пока пользователь явно не вернётся на список каналов.

9.3. Описание канала

Долгое нажатие на комнату → «О канале» показывает описание, подготовленное администратором. Перед входом в закрытую или специальную комнату рекомендуется прочитать описание и правила.

10. Общий сканер каналов

Рисунок 2. Сканер контролирует несколько комнат, но одновременно воспроизводит один активный канал.

10.1. Как выбрать комнаты

1. На экране «Все каналы» удерживайте нужную комнату.
2. Нажмите строку «Сканировать».
3. Повторите для всех нужных открытых и доступных комнат.
4. Останьтесь на списке каналов. После примерно 10 секунд без голосовой активности и действий пользователя scanner перейдёт в ожидание.

10.2. Что происходит при активности

• сервер выбирает первую слышимую активную комнату;
• клиент переключает один актуальный UDP/AES-транспорт на эту комнату;
• появляется центральная RX-карточка «Канал / Говорит» — даже если пользователь отключил карточку RX для обычного режима;
• при нескольких одновременных активностях scanner удерживает текущую, запоминает остальные и после паузы может перейти к следующей;
• несколько комнат не смешиваются в один звук.

10.3. PTT во время сканирования

10.4. Что останавливает scanner

• вход в комнату или открытие окна пароля;
• переход с экрана списка каналов;
• явное действие пользователя во время сканирования;
• снятие всех комнат с мониторинга;
• остановка или потеря соответствующей серверной сессии.

10.5. SVX-комнаты в общем scanner

В режиме списка комнат сервер создаёт виртуальное присутствие пользователя во всех выбранных SVX-комнатах. Это присутствие предназначено только для приёма: пользователь не появляется в счётчике участников, не вступает в чат и не меняет обычную runtime-комнату.

• если в комнате есть personal-node пользователя, scanner слышит его выбранную TG и Monitor TG;
• если personal-node нет, слышна только общая TG шлюза комнаты;
• активность в TG, которую пользователь не имеет права слышать, не захватывает scanner и не показывает ложную карточку;
• при выключении scanner сервер очищает персональные состояния, чтобы старая активность не появилась повторно.

11. Передача и приём голоса

11.1. Передача с экрана

1. Откройте комнату и убедитесь, что никто не говорит.
2. Нажмите и удерживайте PTT.
3. Дождитесь состояния TX/зелёного или красного индикатора, принятого в текущем интерфейсе, и начинайте говорить.
4. Говорите на одинаковом расстоянии от микрофона.
5. Отпустите PTT после окончания фразы.

11.2. Аппаратная PTT-кнопка

Откройте «Меню → Настройки → Выбрать кнопку PTT», затем нажмите нужную аппаратную клавишу. На некоторых терминалах PTT приходит не как обычный KeyEvent, а через vendor broadcast — приложение определит этот режим автоматически.

• назначенная клавиша используется только для PTT и не должна одновременно менять громкость;
• повторяющиеся события удерживаемой кнопки фильтруются;
• короткое случайное нажатие проходит защитное подтверждение и не должно запускать полноценную передачу;
• для Bluetooth-гарнитуры включите отдельную настройку, после чего приложение принимает совместимые media/headset-кнопки.

11.3. BUSY

Если другой пользователь уже передаёт, сервер может отклонить запрос TX и приложение подаст сигнал BUSY. Нажатие PTT во время чужого RX не должно отключать текущий входящий звук. Дождитесь окончания передачи и повторите вызов.

11.4. TOT

TOT ограничивает слишком длинную непрерывную передачу. На карточке TX отображается обратный отсчёт. Перед окончанием лимита приложение может подать специальный сигнал. После срабатывания отпустите PTT и начните новую короткую передачу только после освобождения канала.

11.5. RX-карточка

Карточка показывает аватар и имя говорящего. Переключатель находится в меню собственной карточки пользователя: «Карточка RX». Он скрывает только центральное визуальное окно, но не останавливает звук, состояние RX, сигналы и логику VOX. На списке комнат при активном scanner карточка показывается принудительно, чтобы было понятно, какой канал захвачен.

11.6. Если начало слов пропадает

1. Увеличьте «Буфер начала передачи» с шагом 100 мс.
2. Проверьте правильность выбранного микрофона.
3. На тяжёлом терминале рассмотрите «Разогрев микрофона», прочитав предупреждение о батарее и постоянном индикаторе микрофона.
4. Не завышайте шумодав и порог АРУ, чтобы тихое начало фразы не было принято за фон.
5. Проверьте через «Эхо тест».

12. Пользователи, карточки и приватная связь

12.1. Список пользователей комнаты

В комнате отображаются обычные пользователи PTT Voice и внешние SVX-ноды. Активные SVX-ноды поднимаются выше и получают цветовой акцент. Меню карточки зависит от типа пользователя и ваших прав.

12.2. Аватар

Аватар меняется нажатием на изображение пользователя в настройках. Можно выбрать обычное изображение или GIF. Сервер приводит файл к формату аватара. Для внешних SVX-нод картинка загружается из node-info/status JSON, если она указана владельцем ноды.

12.3. Приватный вызов

1. Откройте меню обычного пользователя и выберите «В приватный канал».
2. У вызывающего появится окно «Вызываю…», у собеседника — «Вызывает…» с кнопками принять или отменить.
3. При принятии сервер создаёт временную комнату «Штаб квартира» и переводит туда обоих пользователей.
4. Говорите обычной PTT-кнопкой.
5. Завершите приват. Оба участника автоматически возвращаются в свои исходные комнаты.

Ожидание ответа ограничено примерно 60 секундами. При пропуске показывается карточка «Пропущенный вызов». Приватный вызов использует тот же PTT Voice 2 транспорт, но отдельную runtime-комнату и отдельный AES-ключ.

13. Чат канала

13.1. Как открыть и закрыть

• в комнате сделайте свайп справа налево;
• для автоматического открытия нажмите 📍, чтобы значок стал 📌;
• закрытие — свайп слева направо;
• если чат закреплён, он открывается после входа в комнату;
• колокольчик внутри чата отдельно включает или отключает звуки чат-уведомлений.

13.2. Отправка сообщения

1. Введите текст или подпись.
2. При необходимости нажмите «+» и выберите файл или медиа.
3. Нажмите 😊 для emoji, стикеров и GIF.
4. Нажмите SEND или кнопку отправки клавиатуры.
5. PTT в чате позволяет говорить, не закрывая чат.

13.3. Возможности сообщений

• ответ на конкретное сообщение с переходом к оригиналу;
• индикатор «печатает…»;
• реакции emoji;
• редактирование и удаление собственных сообщений;
• копирование текста и внешняя отправка через Android;
• изображения с полноэкранной галереей;
• видео с полноэкранным проигрывателем и изменением режима размера;
• аудиофайлы с воспроизведением и перемоткой;
• обычные файлы с загрузкой и последующим открытием;
• предпросмотр ссылок и открытие во внешнем приложении;
• YouTube-ссылки с переходом в подходящий проигрыватель;
• добавление чужого стикера или GIF в свою коллекцию.

13.4. Долгое нажатие на сообщение

Открывает быстрые реакции и действия: «Ответить», «Копировать», «Поделиться», а также контекстные «Открыть», «Скачать», «Добавить себе в стикеры/GIF», «Изменить» и «Удалить». Набор зависит от типа сообщения, вложения и авторства.

13.5. Отправка из других приложений

PTT Voice зарегистрирован как получатель Android Share. Из галереи, файлового менеджера или браузера можно отправить текст, один или несколько файлов в PTT Voice. Если чат уже открыт — материал попадёт в него; иначе приложение попросит выбрать нужную комнату.

13.6. Уведомления чата

Уведомление может вести прямо к комнате и конкретному сообщению. Разрешите системные уведомления. Если сообщения приходят без звука, проверьте колокольчик чата, выбранный звук «Chat In Message» и системный канал уведомлений Android.

14. SVX-комнаты и SVXReflector

Рисунок 3. Пользователь без personal-node работает через шлюз, а зарегистрированный пользователь — через собственное SVX-подключение.

14.1. Что такое SVX-комната

SVX-комната — это комната PTT Voice, связанная серверным мостом со SvxReflector. Пользователь PTT Voice может слышать и вызывать внешние ноды рефлектора, а участники SVX — передачи из приложения.

14.2. Режим через шлюз

Если пользователь имеет доступ к комнате, но для него не создан personal-node, он работает через общий callsign шлюза комнаты. Такой пользователь слушает и передаёт в основную TG комнаты. Это простой режим, не требующий отдельного SVX Login.

14.3. Персональная SVX-нода

Для выбранного пользователя сервер открывает отдельное подключение к рефлектору. Callsign и пароль хранятся отдельно для каждой SVX-комнаты. Пользователь получает персональную выбранную TG, Monitor TG, быстрые переходы и избранные ноды.

14.4. Настройка SVX Login

1. Войдите в SVX-комнату.
2. Откройте меню своей карточки.
3. Выберите «SVX Login».
4. Введите callsign и пароль SVXReflector. Если администратор разрешил саморегистрацию, данные будут сохранены и personal-node подключится автоматически.
5. Дождитесь статуса «вход в SVXReflector выполнен».

По умолчанию приложение предлагает использовать логин PTT Voice как SVX Login. Если отдельный пароль не задан, серверная модель может использовать итоговый callsign как значение по умолчанию. Конкретные требования зависят от рефлектора и политики администратора.

14.5. Основная TG и Location

1. Откройте меню своей personal-node и выберите «Задать мой TG».
2. Укажите TG больше нуля.
3. Укажите Location: QTH, имя или короткую информацию.
4. Сохраните. Основная TG будет использоваться для передачи после возврата из сканирования, а Location отображается в SVX Monitor.

14.6. «Мой SVX-сканер»

14.7. Активные TG и мини-карточки

• красная мини-карточка — нода/TG активна сейчас;
• зелёная — недавно была активна и остаётся видимой примерно минуту;
• тап по карточке временно переключает personal-node на эту TG;
• долгое нажатие добавляет TG в Monitor TG;
• другая Monitor TG не имеет права прервать явно выбранную временную TG до окончания её удержания.

14.8. Переход к ноде

Выберите «Перейти к узлу» в меню SVX-ноды или долго нажмите её карточку. Сервер немедленно отправляет выбор TG через вашу personal-node. Общий шлюз комнаты не переключается, поэтому действие не влияет на остальных пользователей.

14.9. Избранные ноды

• «В избранные» сохраняет callsign и TG;
• «Избранные» в меню собственной карточки открывает список;
• тап выполняет быстрый переход;
• долгое нажатие на строку показывает удаление из списка.

14.10. Информация о ноде

Пункт «Инфо» может показывать callsign, location/QTH, sysop, TG, тип узла, частоты RX/TX, сдвиг, PL-тоны, мощность, программное обеспечение, сайт, подсказку, координаты и кнопку карты. Набор зависит от node_info/status JSON рефлектора.

14.11. АРУ динамика для SVX RX

Переключатель «АРУ динамика» находится в меню собственной карточки в SVX-комнате и хранится отдельно для каждой комнаты. Он выравнивает громкость только входящего SVX-звука: тихие станции подтягиваются, громкие быстро ослабляются, а мягкий limiter подавляет цифровые пики. Обычные PTT Voice-комнаты и системная громкость Android не изменяются.

14.12. Справка SVX и закрытая комната

Кнопка «?» открывает описание, подготовленное администратором: правила входа, регистрацию в рефлекторе, основную TG и другие особенности. Для отказа в доступе сервер также может показать отдельное форматированное объяснение.

14.13. Вход во время уже идущей передачи

Если вы вошли в SVX-комнату посреди активной передачи, сервер восстанавливает реальный callsign и TG из текущего состояния или status JSON. Карточка и звук должны появиться сразу, без ожидания следующего нажатия PTT внешней ноды.

15. Полный разбор настроек

Откройте «Меню → Настройки». На смартфоне это отдельный экран. На PoC настройки адаптируются к устройству. Некоторые смартфонные параметры отсутствуют на кнопочном терминале, а PRO-обработка на BUTTON_POC намеренно не применяется.

15.1. Профиль и интерфейс

15.2. Экран смартфона

15.3. Bluetooth-гарнитура

Переключатель активирует отдельный вход Bluetooth-микрофона и обработку совместимых media/headset-кнопок. Используйте его только с реально подключённой гарнитурой. Если звук стал тихим, узкополосным или Android выбрал неправильный маршрут — выключите настройку и переподключите гарнитуру.

15.4. Выбор микрофона

15.5. Битрейт Opus

15.6. Усиление и обработка микрофона

15.7. Буфер начала передачи

Диапазон 0–1700 мс, шаг 100 мс; в текущем коде default 300 мс. Приложение хранит короткий звук до получения серверного разрешения TX, чтобы не потерять начало фразы. Слишком большое значение может сделать передачу менее естественной, поэтому увеличивайте постепенно.

15.8. Разогрев микрофона

Держит выбранный AudioRecord открытым, пока работает foreground service. Помогает терминалам, которые медленно запускают микрофон и съедают первые слова.

15.9. Джиттер-буфер

15.10. Динамик

15.11. Системные сигналы и вибрация

15.12. Экран «Звуки…»

Позволяет редактировать тональные последовательности RX Start, RX End/Roger, PTT Click, BUSY и TOT; каждую можно прослушать до сохранения. Для входа, выхода, входящего/исходящего чата и приватного вызова выбирается системный звук Android или беззвучный режим.

Формат генератора тонов: частота 150–5900 Гц, длительность и пауза 50–500 мс. Не меняйте последовательности без необходимости: слишком длинные или громкие сигналы мешают речи.

15.13. Назначение PTT и обновления

15.14. Эхо-тест 🦜

Удерживайте Rec и говорите до 10 секунд. После отпускания запись сразу воспроизводится с текущими настройками обработки. Эхо-тест удобен для выбора микрофона, усиления, АРУ, шумодава, EQ и PRO-эффектов до реальной передачи.

16. PRO-функции и VOX

PRO-функции настраиваются локально, но применяются в живой комнате только если администратор выдал соответствующее разрешение. Надпись PRO зелёная при доступе и серая без него. Эхо-тест позволяет предварительно услышать эффект даже до активации, если соответствующий preview разрешён клиентом.

16.1. Эквалайзеры

Эквалайзер микрофона изменяет ваш TX, эквалайзер динамика — RX. Полосы регулируются в пределах примерно −12…+12 dB с шагом 1,5 dB. Избегайте одновременного максимального подъёма нескольких полос: это повышает шум и нагрузку на limiter.

16.2. Реверберация микрофона

16.3. Готовые пресеты голоса

Доступные пресеты: Масяня, Детский голос, Взрослый голос, Женский голос, Лягушка, Кощей, Пустая комната, Студия/сухой голос, Ванная комната, Гелий, Глубокий демон, Бурундук и Рация/старый телефон. Каждый пресет может разрешаться администратором отдельно.

16.4. Свой голос

• высота голоса: −12…+12 полутонов;
• роботизация/зерно;
• тоннель/пространство;
• вау-вау / качание тембра.

Сильные эффекты заметно ухудшают разборчивость. Для рабочих каналов используйте минимальные значения или отключайте эффект.

16.5. VOX PRO

VOX автоматически открывает TX по голосу без удержания PTT. Он работает только на смартфонном экране комнаты, когда приложение на переднем плане, комната использует PTT Voice 2, сервер разрешил VOX, микрофон не выключен и нет текущей чужой или собственной передачи.

17. PoC-терминалы

17.1. Автоматическое определение

Приложение классифицирует устройство как SMARTPHONE, TOUCH_POC или BUTTON_POC по размеру экрана, наличию сенсора и аппаратных клавиш. Это определяет основной layout, навигацию и набор настроек.

17.2. Кнопочный PoC

• HOME — текущая комната и статус IDLE/RX/TX/BUSY;
• USERS — список участников;
• SETTINGS — встроенный overlay настроек;
• LEFT/RIGHT циклически переключают SETTINGS ↔ HOME ↔ USERS;
• UP/DOWN в HOME меняют комнату, в USERS и SETTINGS перемещают выделение;
• ENTER/CENTER активирует выбранный пункт;
• BACK закрывает overlay или возвращает назад;
• назначение PTT выполняется в SETTINGS;
• для Hytera/Meig-подобных устройств может использоваться vendor broadcast.

17.3. Сенсорный PoC

• вертикальный свайп меняет комнату;
• горизонтальный свайп переключает HOME, USERS и SETTINGS;
• сенсорная PTT-кнопка видна только на домашнем экране;
• в USERS и SETTINGS PTT-контролы скрываются, чтобы не перекрывать содержимое.

17.4. Особые default для BUTTON_POC

• АРУ микрофона включено;
• порог шума АРУ −40 dBFS;
• усиление динамика 50%;
• звук приватного вызова включён.

Эти значения применяются только к отсутствующим настройкам. Обновление приложения не перезаписывает уже сохранённый пользовательский профиль.

17.5. Что недоступно или ограничено

Полный чат, богатые смартфонные SVX-карточки, затемнение экрана и часть PRO-эффектов ориентированы на смартфон. На BUTTON_POC PRO-аудио намеренно не применяется даже при старых сохранённых настройках или правах.

18. Фоновая работа, резервирование и обновления

18.1. Фоновый сервис

• работает как foreground service с постоянным уведомлением;
• удерживает CPU wake lock ограниченными интервалами и продлевает его;
• следит за сетью и пересобирает соединение при смене Wi-Fi/LTE;
• восстанавливается после завершения задачи системой, если пользователь не выбрал «Выход»;
• поднимается после перезагрузки устройства и после обновления APK;
• показывает состояния IDLE, RX, TX и BUSY в уведомлении/LED, если устройство поддерживает.

18.2. Длительный простой и краткие обрывы

Клиент использует heartbeat, повторную авторизацию по токену, обновление UDP token и восстановление WebSocket-карты. Personal SVX-node имеет grace-период при кратком reconnect, чтобы не выполнять лишний выход/вход в рефлектор. Это повышает вероятность нормальной передачи после ночного простоя и кратких перебоев сети.

18.3. Основной и резервный сервер

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

18.4. Обновления

1. Оставьте включённым «Проверять наличие обновлений».
2. При выходе новой версии приложение покажет окно с номером и описанием.
3. Нажмите «Установить». APK загружается только по проверенному HTTPS-пути сервера.
4. На Android 8+ при первом обновлении разрешите установку из источника PTT Voice.
5. После установки откройте «Что нового», чтобы проверить список изменений.

Принудительное обновление нельзя отменить, если сервер пометил версию как обязательную. Обычное обновление можно отложить.

19. Рекомендуемые профили настройки

20. Решение проблем

20.1. Что записать перед обращением

• модель устройства и версия Android;
• версия PTT Voice;
• тип сети: Wi-Fi/LTE и происходило ли переключение;
• название комнаты и является ли она SVX;
• время проблемы с точностью до минуты;
• кто говорил и какая TG использовалась;
• что было видно: RX/TX-карточка, BUSY, счётчик, уведомление;
• повторяется ли после перехода в другую комнату или перезапуска.

21. Частые вопросы

Можно ли слушать несколько комнат одновременно?

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

Я вошёл в SVX-комнату, но слышу только одну TG. Почему?

Без personal-node пользователь работает через общий шлюз и основную TG комнаты. Для Monitor TG нужен персональный SVX Login.

Можно ли говорить из scanner?

Первое PTT при захваченном канале переводит в реальную комнату. После входа выполните обычную передачу.

Почему RX-карточка появляется в scanner, хотя я её выключил?

Это специально: на списке комнат всегда нужно видеть канал и говорящего. В обычной комнате настройка продолжает действовать.

Что лучше: AGC или ручное усиление?

При сильно меняющемся расстоянии — AGC. При стабильном микрофоне и тихой обстановке ручной gain проще и предсказуемее.

Разогрев микрофона нужно включать всем?

Нет. Это специальная мера для устройств, которые медленно запускают AudioRecord.

64 кбит/с всегда лучше?

Нет. Для PTT-речи 32 кбит/с обычно достаточно; высокая скорость хуже переживает слабую сеть.

Могут ли PRO-настройки быть сохранены без доступа?

Да, но в живой комнате эффект применится только при активном серверном разрешении. Эхо-тест может использоваться для preview.

Работает ли PTT при погашенном экране?

Да, если foreground service не остановлен прошивкой и аппаратная кнопка доступна приложению.

Можно ли выключить постоянное уведомление?

На современных Android foreground service обязан иметь уведомление. Его полное отключение может привести к остановке фоновой рации.

Это P2P-связь?

Нет. Рабочая модель — центральный PTT Voice 2 UDP-router; WebRTC/P2P не используется.

Сервер расшифровывает и слушает Opus?

UDP-router маршрутизирует сырые зашифрованные пакеты и не декодирует Opus в рабочем media path. При этом сервер управляет ключами комнат и доступом.

22. Глоссарий

Приложение A. Диапазоны и значения настроек

Приложение B. Краткие памятки

B.1. Передача

1. Проверьте, что канал свободен.
2. Удерживайте PTT.
3. Дождитесь TX.
4. Говорите.
5. Отпустите PTT.

B.2. Добавить комнату в scanner

1. Вернитесь на «Все каналы».
2. Долго нажмите комнату.
3. Выберите «Сканировать».
4. Подождите около 10 секунд без действий.

B.3. Настроить personal SVX

1. Войдите в SVX-комнату.
2. Своя карточка → SVX Login.
3. Своя карточка → Задать мой TG.
4. Своя карточка → Мой SVX-сканер.
5. Проверьте переход к активной ноде.

B.4. Если плохо слышно начало

1. Эхо-тест.
2. Prebuffer 500–700 мс.
3. Проверить микрофон.
4. При необходимости warm input.
5. Не завышать шумодав/AGC threshold.

B.5. Стабильная работа в фоне

1. Разрешить уведомления.
2. Убрать ограничение батареи.
3. Разрешить автозапуск.
4. Не нажимать «Выход».
5. Оставить foreground-уведомление.

О редакции документа

Руководство составлено по реальным файлам проекта из архива zq0090a: Android-разметкам и коду MainActivity, SettingsActivity, VoiceManager, ChannelScanController, ChatUiController, PrivateCallManager, PttV2AudioSettings, PttV2ProAudio, а также актуальной документации транспорта, Google-аутентификации и SVX personal-node.

Пользовательские функции могут дополнительно ограничиваться серверными правами, настройками конкретной комнаты, администратором рефлектора, версией Android и возможностями устройства. Если интерфейс отличается, ориентируйтесь на номер версии приложения и раздел «Что нового».