EditorExportPlatformWeb

Наследует: EditorExportPlatform < RefCounted < Object

Экспортер для Интернета.

Описание

Веб-экспортер настраивает способ обработки веб-сборки. В окне «Экспорт» редактора он создается при добавлении нового пресета «Веб».

Примечание: Godot в Вебе визуализируется внутри тега <canvas>. Обычно холст нельзя позиционировать или изменять вручную, но в остальном он действует как основное Window приложения.

Обучающие материалы

Свойства

String

custom_template/debug

String

custom_template/release

int

html/canvas_resize_policy

String

html/custom_html_shell

bool

html/experimental_virtual_keyboard

bool

html/export_icon

bool

html/focus_canvas_on_start

String

html/head_include

Color

progressive_web_app/background_color

int

progressive_web_app/display

bool

progressive_web_app/enabled

bool

progressive_web_app/ensure_cross_origin_isolation_headers

String

progressive_web_app/icon_144x144

String

progressive_web_app/icon_180x180

String

progressive_web_app/icon_512x512

String

progressive_web_app/offline_page

int

progressive_web_app/orientation

int

threads/emscripten_pool_size

int

threads/godot_pool_size

bool

variant/extensions_support

bool

variant/thread_support

bool

vram_texture_compression/for_desktop

bool

vram_texture_compression/for_mobile


Описания свойств

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, встраивает в веб-страницу поддержку виртуальной клавиатуры, которая отображается при необходимости на устройствах с сенсорным экраном.


bool html/export_icon 🔗

Если true, значок проекта будет использоваться в качестве значка веб-страницы этого приложения.


bool html/focus_canvas_on_start 🔗

Если true, холст будет сфокусирован сразу после загрузки приложения, если окно браузера уже находится в фокусе.


String html/head_include 🔗

Дополнительные 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 выделит при запуске. Меньшее значение выделит меньше потоков и потребит меньше системных ресурсов, но вы можете столкнуться с риском исчерпания потоков в пуле и необходимости выделять больше потоков во время выполнения, что может привести к взаимоблокировке.

Примечание: Некоторые браузеры имеют жесткий предел количества потоков, которые могут быть выделены, поэтому лучше быть осторожным и не повышать это число.


int threads/godot_pool_size 🔗

Переопределите размер по умолчанию для 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 для этой веб-сборки.


bool variant/thread_support 🔗

Если true, экспортированная игра будет поддерживать потоки. Для этого требуется веб-сайт «cross-origin-isolated», который может быть сложно настроить и который ограничен по соображениям безопасности (например, невозможность связи со сторонними веб-сайтами).

Если false, экспортированная игра не будет поддерживать потоки. В результате она более подвержена проблемам с производительностью и звуком, но для ее запуска потребуется только веб-сайт HTTPS.


bool vram_texture_compression/for_desktop 🔗

Если true, разрешается оптимизировать текстуры для настольных компьютеров с помощью алгоритма S3TC/BPTC.


bool vram_texture_compression/for_mobile 🔗

Если true, то разрешается оптимизировать текстуры для мобильных устройств с помощью алгоритма ETC2/ASTC.