Files
evening_detective_screen/docs/SCREEN-004_ACCEPTANCE.md
T
2026-10-17 19:29:49 +07:00

75 lines
7.3 KiB
Markdown

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