包含此页的版本：
不含此页的版本：
使用 Web 模板配置 Web 构建并与之交互。
有关模板变量、JavaScript 宏和条件指令的信息，请参阅 Web 模板变量。
配置对象包含构建配置，该配置由代码和数据 URL、产品名称、公司名称和版本组成。您可以使用以下代码定义它：
var buildUrl = "Build";
var config = {
dataUrl: buildUrl + "/{{{ DATA_FILENAME }}}",
frameworkUrl: buildUrl + "/{{{ FRAMEWORK_FILENAME }}}",
codeUrl: buildUrl + "/{{{ CODE_FILENAME }}}",
#if MEMORY_FILENAME
memoryUrl: buildUrl + "/{{{ MEMORY_FILENAME }}}",
#endif
#if SYMBOLS_FILENAME
symbolsUrl: buildUrl + "/{{{ SYMBOLS_FILENAME }}}",
#endif
streamingAssetsUrl: "StreamingAssets",
companyName: "{{{ COMPANY_NAME }}}",
productName: "{{{ PRODUCT_NAME }}}",
productVersion: "{{{ PRODUCT_VERSION }}}",
// additional options can go here, see below
};
在上面的示例中，构建文件夹 URL 存储为名为buildUrl.这在您不知道托管服务器上的嵌入页面和构建文件夹之间的关系的情况下很有用。它使您能够在其他 HTML 文档中重复使用嵌入代码。何时使用它的一个示例是，如果您将Build文件夹到服务器上的另一个位置。您可以调整buildUrl变量，您可以使用相同的嵌入代码。这也适用于StreamingAssets文件夹 （streamingAssetsUrl).
除了在构建中设置 URL 和字段名称外，您还可以在config对象。
| 财产 | 用 |
|---|---|
matchWebGLToCanvasSize: false |
默认情况下（如果设置为 true 或 unset），Unity 会同步WebGL一种在 Web 浏览器中呈现 2D 和 3D 图形的 JavaScript API。Unity Web 构建选项允许 Unity 将内容发布为 JavaScript 程序，这些程序使用 HTML5 技术和 WebGL 渲染 API 在 Web 浏览器中运行 Unity 内容。更多信息 请参阅术语表canvas 渲染目标大小与画布元素的文档对象模型 （DOM） 大小（缩放为 window.devicePixelRatio).如果要手动设置画布 DOM 大小和 WebGL 渲染目标大小，请将其设置为 false。 |
devicePixelRatio: <number> |
此字段允许强制渲染页面的 DPI 缩放比率。设置为 1 可强制渲染为“标准 DPI”（或非 Retina DPI），这有助于提高低端移动设备的性能。默认情况下，此字段未设置，这意味着渲染的页面使用浏览器 DPR 缩放比例，从而导致高 DPI 渲染。 |
autoSyncPersistentDataPath: true |
如果设置为 true，则所有文件都会在 UnityApplication.persistentDataPath目录会自动保留，以便在用户下次重新访问网站时记住内容。如果未设置（或设置为 false），则必须在Application.persistentDataPath目录，方法是调用JS_FileSystem_Sync()JavaScript 函数。 |
构建成功实例化后，Promise 对象的履行处理程序回调将接收新创建的 Unity 实例对象作为参数。若要与生成交互，请调用 Unity 实例的以下方法：
| 方法 | 用 |
|---|---|
unityInstance.SetFullscreen(fullscreen) |
这SetFullscreen方法切换全屏模式。此方法不返回值。注意：您需要使用按钮或按键等用户交互来激活全屏模式。您无法在启动时激活全屏模式。- 要激活全屏模式，请将 fullscreen参数设置为 1。- 要退出全屏模式，请将 fullscreen参数设置为 0。 |
unityInstance.SendMessage(objectName, methodName, value) |
这SendMessage方法向游戏对象发送消息。此方法不返回值。- objectName是场景中对象的名称。- methodName是脚本中当前附加到该对象的方法的名称。- value可以是字符串、数字，也可以是空的。 |
unityInstance.Quit().then(onQuit) |
使用Quit()方法退出运行时并清理 Unity 实例使用的内存。此方法返回一个 Promise 对象。注意：某些浏览器插件会干扰垃圾收集器在调用unityInstance.Quit().禁用浏览器插件以解决问题或参考 Mozilla 文档以获取<iframe>：内联框架元素退出和卸载启用了附加组件的 Unity 应用程序。- onQuitcallback 在生成运行时退出后调用。 |