文档中心 > 开发指南

高性能模式

更新时间:2025/04/09 访问次数:420

一、简介

为提升小游戏在手机淘宝中的运行性能,我们推出了高性能模式,游戏经过简单的适配,将大幅提升流畅度。

二、准备工作

1. 提醒

高性能模式下,内存要求更加严格,触及内存告警水位会在游戏运行时弹出内存不足,请特别注意做好游戏内存优化,建议采取压缩纹理等方案充分优化内存。

另外,后续我们将开放设备内存告警的API,有助于游戏开发者在收到通知后回收一些不必要资源避免进一步加剧内存紧张。

2. 运行环境要求

2.1 手淘版本要求

手淘版本必须>=10.46.0,建议直接更新至最新版本即可。

不满足手淘版本要求的版本,会自动降级进入普通模式。

手淘版本查看路径:我的淘宝 - 设置 - 关于淘宝

2.2 淘宝开发者工具版本要求

建议版本>=3.0.9,或直接更新至最新版本。

淘宝开发者工具版本查看路径:淘宝开发者工具 - 关于

2.3 minigame-biz插件版本要求

插件版本必须>=0.0.25。

插件版本查看路径:执行cd ~/.o3/candidate-extensions,若存在minigame-biz且版本号>=0.0.25则表示插件下载成功,且版本可用。

插件下载方式:

  1. 重启开发者工具,若右下角提示更新插件,点击更新即可。下载后可按照上述版本查看路径确认插件是否可用。
  2. 若重启开发者工具,无更新插件提示,且插件版本未达到可用标准,则可按照下图方式手动安装插件,完成后重启IDE。
  • 执行command + p,进入 插件:安装插件(ReleaseId)
  • 输入 ReleaseId 8ecc2470-1f47-48d9-89b4-c551b929c755

2.4 游戏引擎要求

暂时只支持Cocos引擎。

3. 开启高性能模式

配置 game.json 的 highPerformanceMode 为 true 即可进入高性能模式,通过去掉此开关可以正常回退到普通模式,以便两种模式对比。

{
  "deviceOrientation": "portrait",
    "highPerformanceMode": true,
    "window": {
    "allowsBounceVertical": "NO",
      "transparentTitle": "always",
      "enableMultiAudio": true
  },
  "subpackages": []
}

3.1 高性能模式激活判定

通过IDE本地开发时,开发者可通过vConsole调试浮标简单判断是否处于处于高性能模式。

体验步骤:

  • 扫描真机预览码(非模拟器)。

  • 观察画面角落是否出现vConsole浮标(可点击展开日志面板)。浮标存在表示运行于高性能模式,浮标缺失则表示运行于普通模式

注意:以上方法仅限于本地调试预览,上传发布后的体验版本和线上版本无此差别。

4. 开发调试

开启高性能模式的情况下,模拟器调试与普通模式无区别。

推荐使用扫描预览码,利用vConsole功能进行真机调试;除了真机日志功能外,我们还提供了Network和Storage面板功能,方便开发者调试小游戏。

高性能模式下的IDE真机调试日志功能正在建设中,我们将尽快开放使用。

5. 游戏适配

5.1 环境判断

正常来讲,游戏无需经过改造就能够无缝切换到高性能模式,但不可避免需要做一些声明和适配,下面列举一些常见的适配点。通过 my.env.isHighPerformanceMode 判断当前运行时是否处于高性能模式:

if (my.env.isHighPerformanceMode) {
  // 这里可以针对高性能模式做一些针对性的适配
}

5.2 严格模式

业务代码的JS需要开启严格模式,通常情况下游戏引擎会设置默认开启。

5.3 渲染差异

压缩纹理

推荐使用ASTC格式。

FAQ

关于此文档暂时还没有FAQ
返回
顶部