feat; validate Web Audio engagement, compatibility, and long-run stability on real devices

2026-08-31 23:58:06 +03:00
parent c6544716e7
commit 4ea5280f61
1 changed files with 56 additions and 0 deletions
@@ -0,0 +1,56 @@
+# Проверка звука на устройствах
+
+Этот лист фиксирует Milestone 026. Не записывайте детей и не сохраняйте
+персональные данные: достаточно анонимных наблюдений ответственного взрослого.
+
+## Перед началом
+
+1. Загрузите текущие firmware и LittleFS образы, затем выполните жёсткое
+   обновление страницы.
+2. На каждом устройстве откройте лобби, включите звук явным нажатием и
+   проверьте `Тихо`, `Обычно`, `Громко` и `Мягкие звуки`.
+3. Запишите браузер, ориентацию, способ транспорта (WebSocket или HTTP) и
+   только результат: pass/fail и краткое анонимное замечание.
+
+## Матрица
+
+| Устройство                        | Браузер              | Портрет | Альбом | WS  | HTTP | Результат/замечание |
+| --------------------------------- | -------------------- | ------- | ------ | --- | ---- | ------------------- |
+| Android-телефон                   | Chromium             |         |        |     |      |                     |
+| Android-планшет/второе устройство | Chromium             |         |        |     |      |                     |
+| iPhone/iPad, если доступен        | Safari               |         |        |     |      |                     |
+| Ноутбук                           | браузер и клавиатура |         |        |     |      |                     |
+
+## Сценарии
+
+- После первого нажатия звук включается; после перезагрузки и resume выбор
+  сохраняется. Мгновенное выключение прекращает уже играющий звук.
+- Различимы выбор цели, выстрел, промах, попадание, потопление, входящий
+  результат, ход, комбо, победа, поражение, повтор и действия восстановления.
+- За 30 выстрелов один и тот же тип не звучит подряд одним пресетом. Комбо
+  ×2, ×3 и ×4+ заметно усиливаются, а `Мягкие звуки` короче и спокойнее.
+- Уход в фон, возврат, блокировка/разблокировка и смена вкладки не создают
+  очередь старых звуков. Потеря WebSocket, HTTP-опрос и восстановление не
+  повторяют один результат.
+- Зритель слышит только публичные попадания/промахи/потопления и не получает
+  информацию о скрытых кораблях. Leave, profile reset и full reset безопасно
+  останавливают активный звук.
+- При отключённом или заблокированном Web Audio игра остаётся полностью
+  рабочей и тихой; все события понятны визуально и экранные метки не
+  дублируются бесполезными объявлениями.
+
+## Длительная проверка
+
+Проведите 20 обычных партий со звуком и один 60-минутный сеанс с выстрелами,
+комбо, сбросами, переподключениями и сменой видимости. Зафиксируйте отсутствие
+ошибок консоли, застрявших звуков, роста памяти/таймеров, ухудшения доставки,
+переполнения голосов и просадки heap ESP32. Отметьте, были ли какие-либо
+задержанные или пропущенные важные сигналы.
+
+## Короткая оценка
+
+Ответственный взрослый или взрослый прокси отмечает только: различимы ли
+выстрел/промах/попадание/потопление/победа без чтения; помогают ли звуки
+вниманию; не слишком ли громки, резки, басовиты или тревожны; легко ли найти
+mute и громкость; не провоцируют ли звуки случайные нажатия. При замечании
+укажите тип звука, а не сведения о человеке.