虚幻引擎5文档已被迁移至 Epic开发者社区

HTML5 SDK设置

虚幻引擎4（UE4）HTML5实现利用 Mozilla 的 Emscripten 工具链，将UE4的C++代码交叉编译为Javascript。当从Epic Games Launcher或从Epic的 Github元库下载UE4时，HTML5开发所需的所有 Emscripten 和 Python 文件都将包括在内。这意味着，无需执行任何额外的设置步骤或安装任何额外的软件，即可开始创建HTML5项目。

支持HTML5的Web浏览器

虽然可以使用 32位 Web浏览器运行UE4 HTML5项目，但强烈建议使用 64位 版本的Web浏览器。可通过以下链接找到64位版本的Google Chrome和Firefox Web浏览器

• 64位Google Chrome

• 64位Firefox

多线程支持

使用从源代码编译的UE4编译，可以获得实验性多线程支持。

一些浏览器需要启用特殊标志，才能以多线程模式运行。

• 在Chrome中：利用以下标记启动： --js-flags=--experimental-wasm-threads --enable-features=WebAssembly,SharedArrayBuffer 。另外，可以在 chrome://flags/#enable-webassembly-threads 中启用和禁用它们，将它们作为"WebAssembly threads support"。

• 在Firefox每夜版中，可以设置 javascript.options.shared_memory preference to true 来在 about:config 中启用SharedArrayBuffer。

HTML5必要的项目设置

为了能用UE4正常操作HTML5项目，需要从 项目设置 禁用MSAA。可以通过转到 项目设置（Project Settings） > 渲染（Rendering） > 移动（Mobile） ，然后将 移动MSAA（Mobile MSAA） 选项设置为 没有MSAA （No MSAA） ，做到这一点。

HTML5编译类型

创建HTML5项目的编译时，可以选择创建 开发****编译 或 发行****编译 。为项目创建的编译类型取决于想要完成的任务。

HTML5开发编译：

• 在发行项目之前测试或调试项目时，将使用开发编译。

• 开发编译仅编译未压缩文件。

• 开发编译仅用于本地测试，而不用于部署到网站上。

  在编译项目时生成的Readme.txt文件中，可以找到编译用于开发项目的更多信息。

HTML5发行编译：

• 准备向最终用户发行项目时，使用发行编译。

• 发行编译可以被编译为使用压缩或未压缩文件。

• 发行编译可以进行压缩，从而减小下载大小。

可以执行以下操作来为发行HTML5编译启用或禁用压缩文件：

1. 转到 项目设置（Project Settings） > 平台（Platforms） > HTML5 > 打包（Packaging） ，然后确保启用 在发行打包过程中压缩文件（Compress files during shipping packaging） 。
   

   单击查看大图。

2. 此外还建议执行以下操作：通过转到 项目设置（Project Settings） > 打包（Packaging） > 打包（Packaging） 禁用 使用Pak文件（Use Pak File） 选项，并通过单击 使用Pak文件（Use Pak File） 选项名称旁边的框来禁用此选项。
   

   单击查看大图。

   在编译项目时生成的Readme.txt文件中，可以找到有关编译用于发行项目的更多信息。

启动HTML5项目

安装一个兼容的Web浏览器后，就可以测试一个HTML5项目。为此，请转到 主工具栏 并单击 启动（Launch） 选项旁边的 高级选项（Advanced options） 下拉框。然后从显示的菜单中，单击要使用的浏览器进行选中。

打包HTML5项目

要创建一个可以部署到Web上的打包HTML5项目，需要确保执行以下操作：

1. 首先，转到 文件（File） > 打包项目 （Package Project） ，然后从列表中选择 HTML5**。
   

2. 选择要保存项目的文件夹，然后单击 选择文件夹（Select Folder） 以启动打包过程。

3. 项目完成打包后，打开项目打包到的文件夹，并运行 HTML5LaunchHelper.exe 程序。
   

4. HTML5LaunchHelper.exe 程序将启动一个Web服务器，该服务器配置为提供本地主机上的压缩文件。运行 HTML5LaunchHelper.exe 程序时，可以在显示的命令行窗口中看到此服务器的进度。
   

5. 最后，打开选择的64位Web浏览器，然后输入以下URL：[ 本地主机 地址 ]/[ 项目名称 ].html。这将在Web浏览器中加载UE4 HTML5项目，如下图所示。
   

   您需要根据项目名称输入URL。由于上述项目名称为ThirdPerson，应输入的地址为：http://localhost:8000/ ThirdPerson .html

HTML5 Read Me文件

当您创建一个新的HTML5项目时，UE4将生成一个名为 Readme.txt 的文本文件。在该文件中，您将找到有关如何使HTML5项目在本地和Web上运行的额外信息。

HTML5文件类型

当利用HTML5编译用于开发或部署的UE4项目时，您可以选择压缩或不压缩文件。下表列出了未压缩编译所需的文件以及这些文件包含的信息。

非压缩文件部署所需的文件 - 以下文件是在创建非压缩编译时创建的。

压缩文件部署所需的文件 - 以下文件是在创建压缩编译时创建的。

部署不需要的文件 - 以下文件是在同时创建了压缩版本和未压缩版本的项目时创建的。然而，只有当您的项目正在开发或正在测试时，才需要这些文件。