Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
EditorExportPlatformWeb
Наследует: EditorExportPlatform < RefCounted < Object
Экспортер для Интернета.
Описание
Веб-экспортер настраивает способ обработки веб-сборки. В окне «Экспорт» редактора он создается при добавлении нового пресета «Веб».
Примечание: Godot в Вебе визуализируется внутри тега <canvas>. Обычно холст нельзя позиционировать или изменять вручную, но в остальном он действует как основное Window приложения.
Обучающие материалы
Свойства
Описания свойств
String custom_template/debug 🔗
Путь к файлу пользовательского шаблона экспорта, используемого для отладочных сборок. Если оставить пустым, будет использоваться шаблон по умолчанию.
String custom_template/release 🔗
Путь к файлу пользовательского шаблона экспорта, используемого для релизных сборок. Если оставить пустым, будет использоваться шаблон по умолчанию.
int html/canvas_resize_policy 🔗
Определяет, как Godot должен изменять размер холста.
Нет: Размер холста не изменяется автоматически.
Проект: Размер холста зависит от ProjectSettings.
Адаптивный: Размер холста автоматически изменяется, чтобы вместить как можно большую часть веб-страницы.
String html/custom_html_shell 🔗
Пользовательская HTML-страница, которая оборачивает экспортированную веб-сборку. Если оставить пустым, будет использоваться оболочка HTML по умолчанию.
Для получения дополнительной информации см. Настройка оболочки HTML5 учебник.
bool html/experimental_virtual_keyboard 🔗
Экспериментальное: Это свойство может быть изменено или удалено в будущих версиях.
Если true, встраивает в веб-страницу поддержку виртуальной клавиатуры, которая отображается при необходимости на устройствах с сенсорным экраном.
Если true, значок проекта будет использоваться в качестве значка веб-страницы этого приложения.
bool html/focus_canvas_on_start 🔗
Если true, холст будет сфокусирован сразу после загрузки приложения, если окно браузера уже находится в фокусе.
Дополнительные HTML-теги для включения в <head>, такие как теги <meta>.
Примечание: Вам не нужно добавлять тег <title>, так как он автоматически включается на основе имени проекта.
Color progressive_web_app/background_color 🔗
Цвет фона, используемый в веб-приложении.
int progressive_web_app/display 🔗
Режим отображения для использования в этом прогрессивном веб-приложении. Разные браузеры и платформы могут вести себя по-разному.
Полноэкранный: Отображает приложение в полноэкранном режиме и скрывает все элементы пользовательского интерфейса браузера.
Автономный: Отображает приложение в отдельном окне и скрывает все элементы пользовательского интерфейса браузера.
Минимальный пользовательский интерфейс: Отображает приложение в отдельном окне и показывает только элементы пользовательского интерфейса браузера для навигации.
Браузер: Отображает приложение как обычную веб-страницу.
bool progressive_web_app/enabled 🔗
Если true, то эта веб-сборка превращается в прогрессивное веб-приложение (PWA).
bool progressive_web_app/ensure_cross_origin_isolation_headers 🔗
При включении прогрессивное веб-приложение будет следить за тем, чтобы каждый запрос имел заголовки изоляции между источниками (COEP/COOP).
Это может упростить настройку для обслуживания экспортированной игры.
String progressive_web_app/icon_144x144 🔗
Путь к файлу наименьшего значка для этого веб-приложения. Если не определено, по умолчанию используется значок проекта.
Примечание: Если значок не имеет размер 144×144, он будет автоматически изменен для финальной сборки.
String progressive_web_app/icon_180x180 🔗
Путь к файлу маленькой иконки для этого веб-приложения. Если не определено, по умолчанию используется иконка проекта.
Примечание: Если иконка не имеет размер 180×180, она будет автоматически изменена для финальной сборки.
String progressive_web_app/icon_512x512 🔗
Путь к файлу самого большого значка для этого веб-приложения. Если не определено, по умолчанию используется значок проекта.
Примечание: Если значок не имеет размер 512×512, он будет автоматически изменен для финальной сборки.
String progressive_web_app/offline_page 🔗
Страница для отображения, если сервер, на котором размещена страница, недоступен. Эта страница сохраняется на клиентской машине.
int progressive_web_app/orientation 🔗
Ориентация, используемая при запуске веб-приложения через мобильное устройство.
Любая: Ориентация не устанавливается принудительно.
Альбомная: Принудительно устанавливает горизонтальную компоновку (шире, чем выше).
Портретная: Принудительно устанавливает вертикальную компоновку (выше, чем шире).
int threads/emscripten_pool_size 🔗
Количество потоков, которые emscripten выделит при запуске. Меньшее значение выделит меньше потоков и потребит меньше системных ресурсов, но вы можете столкнуться с риском исчерпания потоков в пуле и необходимости выделять больше потоков во время выполнения, что может привести к взаимоблокировке.
Примечание: Некоторые браузеры имеют жесткий предел количества потоков, которые могут быть выделены, поэтому лучше быть осторожным и не повышать это число.
Переопределите размер по умолчанию для WorkerThreadPool. Этот параметр используется, когда размер ProjectSettings.threading/worker_pool/max_threads установлен на -1 (что и является значением по умолчанию). Этот размер должен быть меньше, чем threads/emscripten_pool_size, иначе могут возникнуть взаимоблокировки.
При использовании потоков этот размер должен быть достаточно большим, чтобы обеспечить работу функций, которые зависят от наличия выделенного потока, таких как ProjectSettings.physics/2d/run_on_separate_thread или ProjectSettings.rendering/driver/threads/thread_model. В целом, лучше всего убедиться, что он как минимум 4 и как минимум 2 или 3 меньше, чем threads/emscripten_pool_size.
bool variant/extensions_support 🔗
Если true, включается поддержка GDExtension для этой веб-сборки.
Если true, экспортированная игра будет поддерживать потоки. Для этого требуется веб-сайт «cross-origin-isolated», который может быть сложно настроить и который ограничен по соображениям безопасности (например, невозможность связи со сторонними веб-сайтами).
Если false, экспортированная игра не будет поддерживать потоки. В результате она более подвержена проблемам с производительностью и звуком, но для ее запуска потребуется только веб-сайт HTTPS.
bool vram_texture_compression/for_desktop 🔗
Если true, разрешается оптимизировать текстуры для настольных компьютеров с помощью алгоритма S3TC/BPTC.
bool vram_texture_compression/for_mobile 🔗
Если true, то разрешается оптимизировать текстуры для мобильных устройств с помощью алгоритма ETC2/ASTC.