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.

为 Web 导出

参见

这个页面描述的是如何将 Godot 项目导出到 HTML。如果你想要找的是从源码编译编辑器或导出模板二进制文件,请阅读 为 Web 平台编译

HTML5 export allows publishing games made in Godot Engine to the browser. This requires support for WebAssembly, WebGL and SharedArrayBuffer in the user's browser.

注意

使用Godot 4以C#编写的项目目前无法导出到Web。若要在Web平台上使用C#,请改用Godot 3。

小技巧

Use the browser-integrated developer console, usually opened with F12 (Cmd + Option + I on macOS), to view debug information like JavaScript, engine, and WebGL errors.

注意

由于SharedArrayBuffer和WebGL 2.0的上游错误,Godot 4的HTML5导出目前无法在macOS和iOS上运作。我们建议改用macOS <doc_exporting_for_macos>`和iOS <doc_exporting_for_ios>`本机导出功能,因为它也会带来更好的性能。

一般来说,Godot 3的HTML5导出与各种浏览器更兼容,特别是在使用GLES2算绘后端(只需要WebGL 1.0)时。

WebGL 版本

Godot 4.0及更高版本只能针对WebGL 2.0(使用兼容性算绘方法)。目前还没有稳定的方法在网路上运作Vulkan应用程序。

有关支持WebGL 2.0的浏览器版本列表,请参阅「我可以使用WebGL 2.0 <https://caniuse.com/webgl2>」。请注意,Safari在WebGL 2.0支持方面存在一些其他浏览器不具备的问题,因此我们建议尽可能使用基于Chromium的浏览器或Firefox。

导出选项

如果可以使用可运行的Web导出模板, 则编辑器中的 停止场景播放编辑的场景 按钮之间会出现一个按钮, 可以在默认浏览器中快速打开游戏进行测试.

If your project uses GDExtension Extension Support needs to be enabled.

If you plan to use VRAM compression make sure that Vram Texture Compression is enabled for the targeted platforms (enabling both For Desktop and For Mobile will result in a bigger, but more compatible export).

如果给出了 自定义HTML Shell 文件的路径, 则将使用它来代替默认的HTML页面. 请参阅 导出自定义 HTML 页面.

Head Include 被附加到生成的HTML页面的 <head> 元素中. 例如, 这允许加载webfonts和第三方JavaScript APIs, 包括CSS或运行JavaScript代码.

重要

每个项目必须生成他们自己的HTML文件。在导出时,几个文本占位符会在生成的HTML文件中被替换,专门用于给定的导出选项。任何对该HTML文件的直接修改都会在以后的导出中丢失。要自定义生成的文件,请使用** 自定义HTML shell**选 项。

限制