docs: record causes and fixes for the audio defects

This commit is contained in:
Loki 2026-10-25 10:02:17 +01:00
parent eed3e28c63
commit 14543f981f
Signed by: boba
GPG key ID: 253067914055423B

View file

@ -14,14 +14,14 @@
| 6 | Шапка сервера | Кнопка «питание» рядом с названием сервера непонятна | A | открыто |
| 7 | Сообщения | В панели при наведении («Ответить, Править, Удалить») странная иконка слева | A | открыто |
| 8 | Эмодзи | Нет выбора эмодзи для текста сообщения и для реакций на сообщения | A | открыто |
| 9 | Звук | В голосовой комнате нет звуков: вход и выход участников, сообщения, упоминание или пинг, mute и unmute, подключение | B | открыто |
| 10a | Голос | По умолчанию стоит режим рации (PTT), выглядит странно и неудобно; нужен обычный режим по активации голоса | B | открыто |
| 9 | Звук | В голосовой комнате нет звуков: вход и выход участников, сообщения, упоминание или пинг, mute и unmute, подключение | B исправлено: звуки событий синтезируются программно, настройки в разделе «Звуки», диагностика ошибок аудио (см. ниже) |
| 10a | Голос | По умолчанию стоит режим рации (PTT), выглядит странно и неудобно; нужен обычный режим по активации голоса | B исправлено: по умолчанию голосовая активность с автоподбором порога |
| 10b | Голосовая комната | Страница слишком серая, текстовые кнопки «Выключить микрофон», «Выключить звук», «Покинуть комнату» неудобны; нужны иконочные кнопки | A | открыто |
| 10c | Голосовая комната | Верхняя строка «Подключение к голосовой комнате…» остаётся, хотя внизу «Голос подключён» | B | открыто |
| 10c | Голосовая комната | Верхняя строка «Подключение к голосовой комнате…» остаётся, хотя внизу «Голос подключён» | B исправлено: единый статус голоса (см. ниже) |
| 10d | Аккаунт | Можно зайти на сервер без аккаунта; регистрация или вход в Central должны быть обязательными | C | открыто |
| 10e | Аватары | Две буквы вместо аватара; при первой регистрации нужен случайный сгенерированный аватар | C | открыто |
| 10f | Отзывчивость | Приложение реагирует медленно; нажатие срабатывает не с одного клика, а со второго | A | открыто |
| 11a | Настройки звука | В списках устройств вывода и микрофона мусорные ALSA-пункты (Discard all samples, Rate Converter Plugin, JACK, Open Sound System) | B | открыто |
| 11a | Настройки звука | В списках устройств вывода и микрофона мусорные ALSA-пункты (Discard all samples, Rate Converter Plugin, JACK, Open Sound System) | B исправлено: фильтр устройств, выбор хранится по идентификатору |
| 11b | Настройки | Те же двойные клики в настройках | A | открыто |
| 12a | Темы | Тема работает странно (чёрная тема: части интерфейса остаются серыми, фон не везде одинаковый) | A | открыто |
| 12b | Аватар | Аватар в панели пользователя обновился, в карточке участника голосовой комнаты остались две буквы | A, C | открыто |
@ -33,3 +33,30 @@
- Отзывчивость: сначала измерить причину (двойной клик, ожидание таймера, фокус), потом чинить, не угадывать.
- Любое изменение протокола сначала в документации (правило репозитория), затем в коде.
- Никаких длинных тире в пользовательских текстах.
## Поток B: причины и исправления
### Нет звука в голосовой комнате (пункты 9 и 10a)
Транспорт исправен: `vnox-e2e-voice` против локального `vnox-serverd` проходит (TLS 1.3, UDP-реле, обмен пакетами в обе стороны). Сбои были на стороне клиента:
1. Режим по умолчанию был рацией (PTT), а кнопка «Hold here to talk» нужна для каждой фразы. Без неё исходящий голос не отправлялся совсем, то есть собеседник «не слышал». Теперь по умолчанию голосовая активность.
2. Порог VAD был примерно -26 dBFS (RMS 0,049 при настройке 40), обычная речь с микрофона без усиления его почти не пересекала. Теперь потолок около -34 dBFS, а порог автоматически опускается чуть выше измеренного шума комнаты (минимум около -48 dBFS), с задержкой закрытия 300 мс.
3. Ошибки открытия потоков захвата и воспроизведения (устройство занято или не даёт f32, пропавшее устройство, отказ `play`) только писались в лог из отдельного потока, а интерфейс показывал «Голос подключён». Теперь потоки сообщают об ошибках в общий приёмник, в строке состояния появляется «Ошибка микрофона» или «Ошибка вывода звука», при отказе обеих половин комната помечается ошибкой. Микрофон, отдающий только цифровую тишину, тоже сообщается. Раз в 10 секунд в лог пишутся счётчики (захвачено, отправлено, получено, декодировано, пик входа), а отклонённые UDP-дейтаграммы (чужой адрес источника, ошибка аутентификации) больше не отбрасываются молча.
4. Выбор формата: принимаются только конфигурации f32 (так построены потоки), для устройств без f32 выдаётся понятная ошибка вместо отказа при открытии потока.
Не подтверждено без доступа к продакшену: что именно слышал пользователь на `central.loki-code.dev`. Если после этих исправлений тишина останется, смотреть строку «voice audio stats» и предупреждения «voice datagram ... ignored» в логе: по ним видно, остановился ли сигнал на микрофоне, в сети или на выходе. Подозрение, которое проверяется только на сервере: адрес `voice.bind` на продакшене должен быть достижим клиентом, иначе пакеты придут с другого адреса и будут проигнорированы.
### Статус подключения (10c)
Причина: при клике на голосовую комнату ставилось свободное сообщение «Joining voice channel…», которое сбрасывалось только при запуске аудио. Повторный клик по комнате, в которой клиент уже находится, сервер не подтверждает, поэтому сообщение оставалось навсегда. Кроме того, страница голоса показывала «Joining voice…» при любом пустом списке участников. Теперь `UiState::voice_status` выводится из состояния соединения и голоса, ожидающий вход хранится отдельно (`pending_voice_join`), боковая панель, страница голоса и статус читают один источник. Повторный клик только показывает комнату. При переходе из комнаты A в B живая сессия A остаётся «подключено» до ответа сервера. Конвейер захвата останавливается всякий раз, когда он не принадлежит текущей голосовой цели (например после удаления комнаты).
### Устройства (11a)
Фильтр в `src/audio/devices/filter.rs`: остаются «По умолчанию (системное)», PipeWire и PulseAudio и по одной записи на аппаратную точку (`sysdefault`, затем `plughw`, `hw`, `hdmi`), без технических хвостов в названиях, отсортировано. Выбор хранится по идентификатору устройства; индексы старых версий переносятся по имени, пропавшее устройство откатывается на системное.
### Звуки (пункт 9)
События: вход и выход из комнаты, вход и выход участника, новое сообщение вне просматриваемого чата, упоминание (`@ник`, `@everyone`, `@here`), выключение и включение микрофона и звука, подключение, потеря связи, ошибка. Источник: программный синтез (`src/audio/sounds/synth.rs`), сторонних файлов нет, см. `docs/THIRD_PARTY.md`. Настройки: общий переключатель, громкость, переключатели «Голосовая комната», «Сообщения», «Упоминания». Сигналы связи и ошибок зависят только от общего переключателя. При выключенном звуке (deafen) звучит только сигнал его включения.
Ограничение: Slint не отдаёт состояние фокуса окна ОС, поэтому «новое сообщение» определяется по тому, какой чат открыт, а не по фокусу окна.