Документация
Docs/ru/reference/video/fullscreen.md
Контракт полноэкранного видео
Сгенерированный справочник. Не редактируйте его источник напрямую. Обновите
BuildTools/VideoInterface.json, затем выполнитеpython BuildTools/docs_video.py --write.
| Индекс | Форматы | Доставка | Декодирование | Полный экран | Встроенное | Проверка | Канонический JSON | Руководство |
| Стабильный ID | Правило | Требование | Причина | Источник |
|---|---|---|---|---|
video.fullscreen.play-api |
Точка входа полноэкранного воспроизведения | Используйте Game.PlayVideo(videoName, canInterrupt, enqueue) для встроенного полноэкранного тракта. | Экспортированный клиентский метод делегирует ClientEngine.PlayVideo. | Source/Scripting/ClientGlobalScriptMethods.cpp |
video.fullscreen.replace |
Замена очищает текущую очередь | Запрос без enqueue заменяет активный ролик и очищает все элементы очереди до попытки загрузить новый путь. | PlayVideo сбрасывает _video и очищает _videoQueue до поиска ресурса. | Source/Client/Client.cpp |
video.fullscreen.enqueue |
Очередь при активном ролике | Устанавливайте enqueue только для добавления после уже активного полноэкранного ролика; без активного ролика запрос стартует сразу и очищает устаревшую очередь. | Ветка enqueue зависит от _video, а ProcessVideo последовательно запускает элементы очереди. | Source/Client/Client.cpp |
video.fullscreen.interrupt |
Прерывание вводом | При true в canInterrupt события key-down, mouse-down и touch останавливают активный ролик; проектируйте проектную политику пропуска вокруг этого широкого набора. | ProcessInputEvent останавливает ролик до обычной обработки ввода для перечисленных классов событий. | Source/Client/Client.cpp |
video.fullscreen.music-pair |
Связка с отдельной музыкой | Используйте video-path|music-path, чтобы остановить текущую музыку и запустить рядом с видео отдельный однократный музыкальный ресурс; дополнительные разделители не образуют плейлист. | PlayVideo разделяет запрос, загружает первый компонент и использует только names[1] для музыки AudioManager. | Source/Client/Client.cpp |
video.fullscreen.music-stop |
Завершение останавливает музыку | Ожидайте, что завершение или прерывание полноэкранного ролика остановит текущую музыкальную группу клиента, включая музыку, не запущенную видео. | ProcessVideo безусловно вызывает StopMusic, когда активный ролик сообщает об остановке. | Source/Client/Client.cpp |
video.fullscreen.draw-order |
Позднее полноэкранное рисование | Ожидайте рисование встроенного кадра после Game.OnRenderIface с растяжением на всю текущую цель рендеринга без alpha blending. | MainLoop вызывает ProcessVideo после OnRenderIface, а DrawTexture без исходной/целевой областей заполняет цель. | Source/Client/Client.cpp, Source/Client/SpriteManager.cpp |
video.fullscreen.missing-file |
Отсутствующий полноэкранный ресурс | Проверяйте существование полноэкранного ресурса до переходов; отсутствующий файл без сообщения оставляет воспроизведение неактивным после очистки текущего ролика и очереди. | Void-путь PlayVideo возвращается при ошибке ReadFile и не предоставляет результата ошибки. | Source/Client/Client.cpp |
video.fullscreen.status |
Состояние воспроизведения включает очередь | Интерпретируйте Game.IsVideoPlaying как состояние active-or-queued, а не доказательство видимого сейчас кадра. | ClientEngine сообщает true для активного воспроизведения или непустой очереди. | Source/Client/Client.h |