跳到主要内容

使用自定义引擎

默认情况下,从编辑器启动 PlayCanvas 应用时会使用最新稳定版引擎。有时你可能需要改用其他引擎构建,例如:

  • 使用最新开发版测试新功能或缺陷修复,或在下次引擎发布前发现潜在回归。
  • 暂时回退到先前的稳定版,规避当前稳定版中的回归问题。
  • 使用自己 fork 的 GitHub 引擎仓库进行开发和调试。
选择正确的引擎:模块版与 UMD 版

加载自定义引擎构建时,应根据项目的脚本类型选择正确格式:

  • 项目中只要包含 ESM 脚本(使用 import/export),就需要使用模块版引擎,URL 中的扩展名为 .mjs。
  • 如果项目仅包含经典脚本(使用 pc.createScript),请使用扩展名为 .js 的 UMD 版。

下面分别介绍这些情况的处理方法:

使用开发版引擎启动​

从编辑器启动应用时,会在新标签页中打开启动页,其 URL 格式如下:

https://launch.playcanvas.com/<scene_id>

在启动页 URL 末尾追加以下字符串即可:

https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-latest.js

要使用压缩构建,请使用:

https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-latest.min.js

要启用调试模式,请使用:

https://launch.playcanvas.com/<scene_id>?debug=true&use_local_engine=https://code.playcanvas.com/playcanvas-latest.dbg.js

使用先前的稳定版引擎启动​

PlayCanvas 引擎的历史稳定构建归档在 code.playcanvas.com。所有历史发布版本都可以在 GitHub 上找到。引擎文件采用以下命名规则:

playcanvas-<major>.<minor>.<patch>.js

例如:

playcanvas-0.225.0.js

要使用该指定构建启动,请使用以下 URL:

https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-0.225.0.js

要使用压缩构建,请使用:

https://launch.playcanvas.com/<scene_id>?use_local_engine=https://code.playcanvas.com/playcanvas-0.225.0.min.js
提示

编辑器仅正式支持当前引擎版本和上一个次版本。更早版本有时仍然可用,但这不属于长期支持的工作流。强烈建议持续维护的项目更新到当前引擎版本。

使用本地构建的引擎启动​

fork GitHub 上的引擎仓库后,可以通过 npm run build 自行构建引擎。要让启动页使用自定义构建,需要运行 npm run serve 启动本地 Web 服务器。

确认可以通过以下 URL 访问引擎源码:

http://localhost:51000/playcanvas.js

要在启动页中使用该引擎,请将 URL 修改为:

https://launch.playcanvas.com/<scene_id>?use_local_engine=http://localhost:51000/playcanvas.js