# 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.