Документация
Docs/ru/reference/video/validation.md
Контракт проверки видео
Сгенерированный справочник. Не редактируйте его источник напрямую. Обновите
BuildTools/VideoInterface.json, затем выполнитеpython BuildTools/docs_video.py --write.
| Индекс | Форматы | Доставка | Декодирование | Полный экран | Встроенное | Проверка | Канонический JSON | Руководство |
| Стабильный ID | Правило | Требование | Причина | Источник |
|---|---|---|---|---|
video.validation.raw-copy |
Проверка доставленных байтов | Запеките и проверьте точный путь и байты клиентского ресурса до runtime-воспроизведения. | RawCopy является единственным преобразованием доставки, а runtime-пути точны. | Source/Tools/RawCopyBaker.cpp |
video.validation.visible-client |
Требование видимого клиента | На каждой заявленной платформе проверьте в видимом клиенте первый кадр, движение, конец, пропуск, очередь, изменение размера и очистку текстуры. | Ни headless-, ни source-only-проверка не доказывает загрузку и показ текстуры. | Source/Client/Client.cpp |
video.validation.no-native-fixture |
Отсутствующий нативный video fixture | Считайте отсутствие Test_Video или Test_Theora пробелом покрытия и сохраняйте обязательными видимые регрессионные доказательства. | Текущий набор нативных тестов не содержит сфокусированного исходника декодера/воспроизведения видео. | Source/Tests/README.md |
video.validation.loop-risk |
Зацикливание требует явного доказательства | Не обещайте зацикленные ролики, пока многоцикловая визуальная регрессия не докажет перемотку декодера и непрерывность кадров точного ресурса. | SetLooped доступен при создании, но текущие исходники не имеют сфокусированного loop fixture. | Source/Client/VideoClip.cpp |
video.validation.project-boundary |
Приёмка встраиваемого проекта | Встраиваемый проект владеет триггерами роликов, получателями, политикой пропуска/очереди, субтитрами, локализацией, вписыванием по пропорциям, аудиостратегией, последствиями сохранения, ресурсами, provenance, бюджетами и приёмочными тестами. | Engine поставляет примитивы декодера и показа, а не игровую систему роликов. | Source/Scripting/ClientGlobalScriptMethods.cpp |
Команды проверки
python BuildTools\docs_video.py --check
python -m unittest BuildTools.tests.test_docs_video
cmake --build <build-dir> --config RelWithDebInfo --target RunUnitTests
Сфокусированный нативный fixture декодера/воспроизведения видео отсутствует. Видимый клиент должен доказать первый кадр, устойчивое движение, завершение, пропуск, переходы очереди, изменение размера, поведение связанной музыки, очистку и многоцикловое зацикливание для каждого точного ресурса и заявленной платформы.