跳到主要内容

Laya 接入指南

一、构建/发布​

芒果小游戏运行于WebView，采用 Laya 系列引擎开发的游戏，发布芒果小游戏核心步骤：

1.1 构建​

选择发布为Web游戏 → 构建完成，但需注意除首包外，其它资源进行远程加载。

layaair 3.x 引擎官方发布文档：

LayaAir 3.x Web 发布文档

1.2 补文件​

在构建产物根目录，手动追加以下文件：

  • project.config.json
  • game.json

文件内容请参考官方文件说明。

1.3 提交​

使用 芒果开发者工具 直接导入该目录：

  1. 调试
  2. 预览
  3. 一键上传，完成上线

建议：使用真机测试，确保游戏在真实环境下运行正常。

二、包体优化注意事项​

对上传平台的包体进行了大小限制，需注意以下四点：

2.1 分包​

  • 推荐做法：将游戏资源进行远程分包/远程加载资源，并将这些分包部署在 CDN 服务器上，进行远程分包/资源，不要进行本地分包/资源。
  • 目的：减少初始包体大小，加快首次加载速度，提升用户转化率。

2.2 加载分包​

  • LayaAir 2.x：在代码中加载远程资源时，需手动指定 CDN 地址，例如：

    Laya.loader.load("https://myserver.com/res/image1.png");

    注意：不能依赖默认路径，必须显式拼接远程地址

  • LayaAir 3.x：远程分包，见官方文档介绍：

    LayaAir 3.x Web 发布文档

2.3 真机加载失败排查建议​

  • 问题现象：分包在芒果开发者工具中能正常加载，但在真机上失败。
  • 常见原因：CDN 未正确配置跨域（CORS）。
  • 解决方案：检查并配置 CDN 的跨域设置，参考提供的《设置跨域指南》。

2.4 上传包体大小与转化率关系​

  • 芒果开发者工具会将发布后目录中的所有内容打包上传。
  • 用户首次进入游戏需经历：下载包体 → 解压 → 启动游戏
  • 结论：包体越小，下载越快，转化率越高。
  • 建议：尽可能压缩资源、剔除冗余文件、使用远程分包等手段最小化上传包体体积。

三、接入平台接口​

在游戏中，引用芒果小游戏平台的接口，以 isLogin 为例，有以下几种方式：

window.mgtv.isLogin();//window['mgtv'].isLogin()、mgtv.isLogin();

四、调试​

需要查看调试日志信息时，在发布后的 index.html 中加入以下代码：

<script type="text/javascript" src="https://unpkg.com/vconsole@latest/dist/vconsole.min.js"></script>
<script type="text/javascript">
  new window.VConsole();
</script>

注意：正式发布版本时，需要隐藏相关调试设置。