evening_detective_screen/docs/SCREEN-004_ACCEPTANCE.md

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.