EditorExportPlatformWeb

继承: EditorExportPlatform < RefCounted < Object

Web 导出器。

描述

Web 导出器能够自定义 web 构建的处理方式。在编辑器的“导出”窗口中,添加“Web”预设时会创建这个导出器。

注意: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

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 应如何调整画布的大小。

  • None:画布不会自动调整大小。

  • Project:画布的大小由 ProjectSettings 决定。

  • Adaptive:画布自动调整到尽可能覆盖 Web 页面的大小。


String html/custom_html_shell 🔗

包裹导出后 Web 构建的自定义 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 🔗

要在 <head> 中额外添加的 HTML 标签,例如 <meta> 标签。

注意:<title> 标签无须自行添加,会根据项目名称自动添加。


Color progressive_web_app/background_color 🔗

Web 应用程序后面使用的背景颜色。


int progressive_web_app/display 🔗

用于该渐进式 Web 应用程序的 显示模式。不同的浏览器和平台的行为可能不同。

  • 全屏:全屏显示应用程序并隐藏所有浏览器的 UI 元素。

  • 独立:在单独的窗口中显示应用程序并隐藏所有浏览器的 UI 元素。

  • 最小 UI:在单独的窗口中显示应用程序,并且仅显示浏览器的 UI 元素以进行导航。

  • 浏览器:将应用程序显示为普通网页。


bool progressive_web_app/enabled 🔗

如果为 true,则会将该 Web 构建设置为 渐进式网络应用程序(PWA)。


bool progressive_web_app/ensure_cross_origin_isolation_headers 🔗

启用后,渐进式 Web 应用程序将确保每个请求都具有跨源隔离标头(COEP/COOP)。

这可以简化设置以服务导出的游戏。


String progressive_web_app/icon_144x144 🔗

该 Web 应用程序的最小图标的文件路径。如果未定义,则默认为项目图标。

注意:如果图标不是 144x144,则它将自动调整大小以适应最终构建。


String progressive_web_app/icon_180x180 🔗

该 Web 应用程序的小图标的文件路径。如果未定义,则默认为项目图标。

注意:如果图标不是 180x180,则它将自动调整大小以适应最终构建。


String progressive_web_app/icon_512x512 🔗

该 Web 应用程序的最小图标的文件路径。如果未定义,则默认为项目图标。

注意:如果图标不是 512x512,则它将自动调整大小以适应最终构建。


String progressive_web_app/offline_page 🔗

如果托管该页面的服务器不可用,则显示该页面。该页面保存在客户端的机器中。


int progressive_web_app/orientation 🔗

通过移动设备运行 Web 应用程序时要使用的方向。

  • 任意:不强制方向。

  • 横向:强制水平布局(宽度大于高度)。

  • 纵向:强制垂直布局(高度大于宽度)。


bool variant/extensions_support 🔗

如果为 true,则启用对该 Web 构建的 GDExtension 支持。


bool variant/thread_support 🔗

如果为 true,则导出的游戏将支持多线程。多线程支持要求网站支持“跨源隔离”,设置起来可能比较麻烦,并且可能会由于安全原因而受到限制(例如无法与第三方网站通信)。

如果为 false,则导出的游戏将不支持多线程。因此,游戏会更容易出现性能和音频问题,但只要求在 HTTPS 网站上运行。


bool vram_texture_compression/for_desktop 🔗

如果为 true,则允许通过 S3TC 算法针对桌面优化纹理。


bool vram_texture_compression/for_mobile 🔗

如果为 true,则允许通过 ETC2 算法针对移动设备优化纹理。