up

docs/SCREEN-004_ACCEPTANCE.md

@@ -0,0 +1,74 @@
+# SCREEN-004 — аппаратная проверка локального проигрывателя
+
+Статус: **открыта**. Программная часть проверена на Linux x64, 37 тестов и GUI
+smoke пройдены. Программные миллисекунды не подтверждают физический p95.
+SCREEN-004 остаётся IN_PROGRESS до результатов владельца на всей матрице.
+
+## Подготовка
+
+1. Используйте Node.js 24.15+, установленные зависимости и ffmpeg. Выполните
+   `npm run media:generate`, затем `npm run acceptance` из корня screen.
+2. Подключите реальный монитор/проектор в режиме расширения. Пульт должен остаться
+   на основном дисплее компьютера. Ручная проверка не подставляет синтетический монитор.
+3. Команда создаст отдельный временный каталог данных и пакет «Offline smoke»:
+   WAV-вступление, H.264/AAC-видео и два четырёхсекундных тональных трека.
+   Путь данных печатается как SCREEN004_ACCEPTANCE_READY. Откройте пакет через
+   «Материалы показа», выберите внешний дисплей и нажмите «Открыть показ».
+4. Отключите сеть после запуска. Не используйте --mute-audio для физической проверки.
+   Установите подходящую громкость и проверьте нужный аудиовыход ОС. Параметры
+   --no-sandbox/--disable-gpu, применённые в автоматическом smoke текущей среды,
+   не являются обязательными параметрами приложения; запишите использованные флаги.
+5. Между сборками закрывайте приложение: test и smoke изменяют общий dist-electron.
+
+## Сценарии
+
+- Выберите вступление, дождитесь готовности, проверьте пуск с начала, паузу,
+  продолжение, повтор с начала и остановку. Пауза не должна отматывать звук назад.
+- Перемотайте на середину в воспроизведении и на паузе; затем на конец.
+  Проверьте фактическую позицию и сохранение состояния паузы/воспроизведения.
+- Переключитесь на заключительное видео: вступление прекращается. Повторите
+  команды и перемотку, проверьте изображение и звук на внешнем дисплее.
+- Запустите музыку вместе с видео/вступлением: оба канала слышны независимо,
+  автоматического приглушения нет. Изменение громкости одного канала не должно
+  перематывать его или менять другой. Общий mute отключает оба; снятие сохраняет уровни.
+- Проверьте выбор трека, «Следующий трек» на паузе и в воспроизведении,
+  автоматический переход, завершение второго трека без повтора и переход
+  со второго на первый с включённым повтором. Музыка не должна удваиваться.
+- Несколько раз быстро выполните пуск → перемотка → пауза, затем пуск → стоп,
+  переключение вступление/видео и смену пакета. Последнее действие побеждает,
+  поздний play не оживляет предыдущий ресурс.
+- Закройте окно показа и откройте снова. Проверьте оба канала: звук не начинается
+  до явной команды, позиции сброшены. Пульт и технические ошибки не видны на проекторе.
+- Проверьте отдельный тестовый режим SCREEN-001. Он не должен подменять выбранный
+  игровой пакет автоматически во время нормального воспроизведения.
+
+## Измерение задержки
+
+На каждом формате и проверяемом аудиовыходе выполните не менее 30 запусков уже
+подготовленного медиа. Холодный запуск/первую подготовку запишите отдельно.
+Для физической задержки используйте синхронную запись действия на пульте и первого
+слышимого звука/видимого кадра; методику и погрешность опишите в результате.
+На MacBook Air M1, 16 ГБ RAM, физический p95 должен быть ≤150 мс.
+Остальные варианты также требуют проверки, но тот же порог для них не заявлен.
+
+Раскройте «Программные замеры запуска» в пульте: эти значения показывают только
+приём команды → подтверждение проигрывателя, разделены по каналу и типу медиа.
+Не выдавайте их за измерение физического выхода. Для чистой серии запускайте
+ручную проверку заново; счётчики не сохраняются между запусками приложения.
+
+## Матрица и отчёт
+
+| Платформа | Архитектура | Результат |
+| --- | --- | --- |
+| macOS 13+ | Intel x64 | Открыто |
+| macOS 13+ | Apple Silicon ARM64 | Открыто; M1 p95 ≤150 мс |
+| Windows 11 | x64 | Открыто |
+| Windows 11 | ARM64 | Открыто |
+| Ubuntu 24.04 LTS / Debian 13 | x64 | Открыто для обоих дистрибутивов |
+| Ubuntu 24.04 LTS / Debian 13 | ARM64 | Открыто для обоих дистрибутивов |
+
+Для каждого прогона передайте: ОС/версию, архитектуру, CPU/RAM, версию Electron,
+монитор/проектор, переходник, аудиовыход, формат, число запусков, программный и
+физический p95 отдельно, методику измерения, пройденные сценарии и ошибки.
+Установочные архивы для SCREEN-004 пока не пересобирались; ручная команда проверяет
+текущий исходный код. Проверка установочных артефактов относится к SCREEN-008.