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
Web 导出器。
描述
Web 导出器能够自定义 web 构建的处理方式。在编辑器的“导出”窗口中,添加“Web”预设时会创建这个导出器。
注意:Web 上的 Godot 是在一个 <canvas>
标签中渲染的。这个画布是作为程序的主 Window 使用的,但是一般没有办法手动调整位置和大小。
教程
属性
属性说明
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
,则将对虚拟键盘的支持嵌入到网页中,在触摸屏设备上会在必要时显示。
如果为 true
,则项目图标将用作该应用程序网页的图标。
bool html/focus_canvas_on_start 🔗
如果为 true
,则浏览器窗口已经获得焦点,且一旦加载应用程序时,画布就会获得焦点。
要在 <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 应用程序的最小图标的文件路径。如果未定义,则默认为项目图标。
注意:如果图标不是 144×144,则它将自动调整大小以适应最终构建。
String progressive_web_app/icon_180x180 🔗
该 Web 应用程序的小图标的文件路径。如果未定义,则默认为项目图标。
注意:如果图标不是 180×180,则它将自动调整大小以适应最终构建。
String progressive_web_app/icon_512x512 🔗
该 Web 应用程序的最小图标的文件路径。如果未定义,则默认为项目图标。
注意:如果图标不是 512×512,则它将自动调整大小以适应最终构建。
String progressive_web_app/offline_page 🔗
如果托管该页面的服务器不可用,则显示该页面。该页面保存在客户端的机器中。
int progressive_web_app/orientation 🔗
通过移动设备运行 Web 应用程序时要使用的方向。
任意:不强制方向。
横向:强制水平布局(宽度大于高度)。
纵向:强制垂直布局(高度大于宽度)。
bool variant/extensions_support 🔗
如果为 true
,则启用对该 Web 构建的 GDExtension 支持。
如果为 true
,则导出的游戏将支持多线程。多线程支持要求网站支持“跨源隔离”,设置起来可能比较麻烦,并且可能会由于安全原因而受到限制(例如无法与第三方网站通信)。
如果为 false
,则导出的游戏将不支持多线程。因此,游戏会更容易出现性能和音频问题,但只要求在 HTTPS 网站上运行。
bool vram_texture_compression/for_desktop 🔗
如果为 true
,则允许通过 S3TC/BPTC 算法针对桌面优化纹理。
bool vram_texture_compression/for_mobile 🔗
如果为 true
,则允许通过 ETC2/ASTC 算法针对移动设备优化纹理。