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.

EditorExportPlatformWeb

Успадковує: EditorExportPlatform < RefCounted < Object

Експортер для Web.

Опис

Веб-експортер налаштовує, як працює веб-будування. У вікні редактора "Експорт" створюється при додаванні нового "Веб"

Примітка: 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-сторінка, яка обмотує експортовану веб-будову. Якщо лівий порожній, використовується оболонка за замовчуванням.

Для отримання додаткової інформації див. у Customizing HTML5 Shell підручник.


bool html/experimental_virtual_keyboard 🔗

Експериментальний: Ця властивість може бути змінена або усунута у наступних версіях.

Якщо true, посольство підтримує віртуальну клавіатуру на веб-сторінці, яка показана при необхідності на сенсорних пристроях.


bool html/export_icon 🔗

Якщо true, ікона проекту буде використовуватися як favicon для цієї сторінки програми.


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 🔗

Виберіть режим для цього прогресивного веб-додатку. Різні веб-переглядачі та платформи не можуть бути однаковими.

Повний екран: Відображує додаток в повноекранному режимі і приховує всі елементи інтерфейсу браузера.

  • Standalone: Відображує додаток в окремому вікні і приховує всі елементи інтерфейсу браузера.

  • Minimal UI: Відображає додаток в окремому вікні і тільки показує елементи інтерфейсу браузера для навігації.

Browser: Відобразити додаток як нормальну веб-сторінку.


bool progressive_web_app/enabled 🔗

Якщо true, перетворює цю веб-будову в progressive веб-додаток (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 🔗

Консультація на використання при запуску веб-додатку через мобільний пристрій.

Ані: Немає орієнта примусово.

  • Landscape: Сил горизонтальний макет (ширше, ніж він високе).

  • Портрет: Сили вертикальне планування (талер, ніж він ширший).


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, експортована гра буде підтримувати нитки. Для цього потрібен a "перехресний ізольований" веб-сайт, який може бути важко налаштувати і обмежений з причин безпеки (наприклад, не здатний спілкуватися з сторонніми веб-сайтами).

Якщо false, експортована гра не підтримує нитки. Як результат, це більш схильний до виконання та аудіо питань, але буде потрібно працювати лише на сайті HTTPS.


bool vram_texture_compression/for_desktop 🔗

Якщо true, дозволяє оптимізувати текстури для робочого столу за допомогою алгоритму S3TC/BPTC.


bool vram_texture_compression/for_mobile 🔗

Якщо true дозволяє оптимізувати текстури для мобільних пристроїв за допомогою алгоритму ETC2/ASTC.