This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English
Манифест приложения определяет, какие функции и бэкенды компонуются с движком. Неиспользуемые функции рекомендуется исключать, поскольку это уменьшает итоговый размер бинарного файла игры. Манифест приложения также содержит параметры времени сборки, например минимальные поддерживаемые версии браузеров HTML5 и настройки памяти WebAssembly.

В game.project назначьте манифест в разделе Native Extensions -> App Manifest.
Выберите реализацию Box2D, которую нужно включить:
Параметры решателя Box2D зависят от версии. Подробнее см. в настройках проекта Box2D.
Включает реализацию 3D-физики Bullet. Она включена по умолчанию; отключите этот параметр, чтобы исключить 3D-физику.
Позволяет управлять функциональностью rig и model, либо выбрать None, чтобы полностью исключить модели и риги. См. документацию по Model.
Исключает нативную запись MP4, модуль Lua recorder и HTTP-сервис записи из отладочных сборок для настольных платформ. Запись уже исключена из релизных сборок, сборок без графики, а также мобильных и веб-сборок. О работе с записью см. в руководстве по записи видео.
Определяет, когда функциональность профайлера компонуется с движком:
Параметр манифеста приложения определяет, будет ли код профайлера скомпонован со сборкой. Параметры раздела profiler в game.project управляют поведением профайлера во время выполнения. Доступные возможности описаны в руководстве по профилированию.
Параметры звука определяют, какая звуковая система и какие декодеры компонуются с движком.
Исключает из движка всю функциональность воспроизведения звука.
Исключает поддержку звуковых ресурсов WAV.
Исключает поддержку звуковых ресурсов Ogg Vorbis.
Включает поддержку звуковых ресурсов Ogg Opus. Декодер Opus по умолчанию исключён, поэтому перед воспроизведением ресурсов .opus этот параметр необходимо включить. Поддерживаемые форматы перечислены в руководстве по звуку.
Исключает из движка всю обработку ввода.
Исключает из движка ресурсы, компоненты и поддержку Lua для GUI. Включайте этот параметр только в том случае, если проект не использует GUI-сцены или GUI-скрипты. Компоненты Label остаются доступными. По умолчанию параметр отключён.
Исключает ресурсы и компоненты эффектов частиц, а также модуль Lua particlefx. Это также исключает поддержку нод частиц в GUI-сценах; GUI-сцены без нод частиц продолжают поддерживаться. Прежде чем включать этот параметр, удалите ссылки на эффекты частиц и вызовы их API. По умолчанию он отключён.
Исключает ресурсы и компоненты тайловых карт, а также модуль Lua tilemap. Включайте этот параметр только в том случае, если проект не использует компоненты Tilemap или их API. Источники тайлов, используемые другими компонентами, остаются доступными. По умолчанию параметр отключён.
Исключает из движка функциональность Live Update.
Исключает из движка скриптовый модуль image: документация.
Исключает из движка скриптовый модуль types: документация.
Исключает из движка библиотеку сжатия текстур Basis Universal. Подробнее см. в руководстве по профилям текстур.
Использует устаревшую Android Support Library вместо Android X. Подробнее.
Позволяет выбрать графические бэкенды, включаемые для каждой платформы. Комбинированный вариант включает несколько бэкендов, чтобы движок мог перейти на резервный, если предпочтительный недоступен. Включение дополнительных бэкендов увеличивает размер движка.
Для Windows и Linux используются отдельные поля. Вариант DX12 выбирает DirectX 12 в Windows.
| Поле | Платформы | Варианты | По умолчанию |
|---|---|---|---|
| Graphics (Linux) | Linux | OpenGL, Vulkan, OpenGL & Vulkan | OpenGL |
| Graphics (Windows) | Windows | OpenGL, Vulkan, DX12, OpenGL & Vulkan, OpenGL & DX12, Vulkan & DX12, OpenGL & Vulkan & DX12 | OpenGL |
| Graphics (macOS) | macOS | OpenGL, Metal, Vulkan, OpenGL & Metal, OpenGL & Vulkan | Metal |
| Graphics (iOS) | iOS | OpenGL, Metal, Vulkan, OpenGL & Metal, OpenGL & Vulkan | OpenGL |
| Graphics (Android) | Android | OpenGL+Vulkan, OpenGL, Vulkan | OpenGL+Vulkan |
| Graphics (HTML5) | HTML5 | WebGL, WebGPU, WebGL & WebGPU | WebGL |
В Linux ARM64 вариант OpenGL использует backend OpenGL ES. Комбинированный вариант Android по умолчанию предпочитает Vulkan, а если он недоступен, переходит на OpenGL ES.
macOS по умолчанию использует нативный бэкенд Metal. Вариант Vulkan на macOS и iOS использует Vulkan через MoltenVK. Симулятор iOS (arm64_sim-ios) всегда использует Metal независимо от выбранного для устройств варианта Graphics (iOS).
Если включено (true), включает полную систему раскладки текста с поддержкой формирования глифов, в том числе для языков с письмом справа налево. Включите этот параметр для генерации шрифтов TrueType (.ttf) или OpenType (.otf) во время выполнения и установите Glyph Generation в Dynamic в каждом ресурсе шрифта, которому это необходимо. Динамическая генерация поддерживает режимы SDF и Vector. Подробнее см. в руководстве по шрифтам.
Включает разбор форматированной текстовой разметки и стилевые эффекты для меток и GUI-текста. По умолчанию этот параметр включён. Отключите его, чтобы уменьшить размер движка, если проекту нужен только обычный текст. Метки и GUI-текст продолжат поддерживаться, но разметка будет отображаться как обычный текст без применения форматирования или эффектов.
Поля YAML minSafariVersion, minFirefoxVersion и minChromeVersion задают минимальные версии браузеров, на которые ориентируется Emscripten. Текущие значения по умолчанию и минимальные поддерживаемые версии различаются для однопоточной и многопоточной целей:
| Цель | Safari | Firefox | Chrome |
|---|---|---|---|
wasm-web |
101000 |
40 |
45 |
wasm_pthread-web |
150000 |
79 |
75 |
Указывайте переопределения в контексте соответствующей цели. Для многопоточной цели также действуют дополнительные требования к хостингу. См. справочник параметров Emscripten: MIN_SAFARI_VERSION, MIN_FIREFOX_VERSION и MIN_CHROME_VERSION.
Имя поля в YAML: initialMemory
Значение по умолчанию: 33554432
Начальный объём памяти, выделяемой веб-приложению, в байтах. Значение должно быть кратно размеру страницы WebAssembly (64 КиБ). См. параметр Emscripten INITIAL_MEMORY.
Этот параметр задаёт значение по умолчанию во время компиляции. Значение html5.heap_size в game.project переопределяет его во время выполнения.
Имя поля в YAML: stackSize
Значение по умолчанию: 5242880
Размер стека приложения в байтах. См. параметр Emscripten STACK_SIZE.