# EmscriptenGLX 渲染模式
EmscriptenGLX 是一种可选的高性能渲染模式。本章介绍它的作用、启用方式与适用范围。普通转换无需开启此项也能正常运行。
# 一、简介
在默认渲染模式下，游戏内的 GL 指令需要经过多层转换：WASM（业务逻辑） → JS 胶水层（GL → WebGL） → 平台渲染。其中 WASM 与 JavaScript 之间的高频通信会带来可观的性能开销。
启用 EmscriptenGLX 渲染模式后，GL → WebGL 指令的处理被下沉到 WASM 内部完成，从而消除 WASM 与 JS 之间的高频调用链路，在渲染密集的场景下有助于降低单帧耗时。
# 二、适用范围与说明
- 引擎版本：支持 Unity 2021.2+ 与团结引擎接入；更低版本请使用默认渲染模式。
- 运行平台：Android 端与 iOS 端目前均处于内部测试阶段——相关转换 SDK 与容器版本尚未正式发版，正式渠道暂不可用；如需在这两个平台接入验证，请联系运营获取对应的测试版本（测试版转换 SDK 与测试 App），并以正式发版通知为准。其他运行环境会自动降级为默认的 WebGL 渲染模式，游戏表现不受影响。
- 建议充分验证后再发布：该模式重构了 GL 指令的处理链路，发布前请在目标机型上完整验证渲染表现。
自动降级是设计内的安全兜底：当运行环境不满足启用条件时，容器会无感切回默认渲染模式，游戏仍可正常运行，无需开发者额外处理。
EmscriptenGLX 目前处于内部测试阶段（Android 与 iOS 均尚未正式发版），正式渠道暂不可用；是否采用请以正式发版通知为准，需提前评估请按上文联系运营获取测试版本。
# 三、开启方式
EmscriptenGLX 在转换阶段开启，无需改动游戏代码：
- 确认引擎版本为 Unity 2021.2+ 或团结引擎。
- 在 **「美团小游戏 → 转换小游戏」**面板的 **「调试编译选项」**中勾选
EmscriptenGLX。 - 点击 **「生成并转换」**完成导出。
# 四、如何确认已生效
- 删除真机上已缓存的小游戏（含调试版本），确保重新加载最新包。
- 通过
mgc debug重新进入游戏并打开开发者面板，查看启动日志：在 WebGL 上下文创建前后，确认包含 EmscriptenGLX 已启用的相关日志。 - 若日志显示已降级为默认渲染模式，请对照「二、适用范围」逐项检查引擎版本与运行平台。
# 五、常见问题
Q1. 开启后日志显示仍是默认渲染模式？
请确认：引擎为 Unity 2021.2+ 或团结引擎、运行在受支持的平台、转换面板确实勾选了 EmscriptenGLX。任一条件不满足都会自动降级。
Q2. 开启后出现渲染异常？
请先确认游戏在默认渲染模式下渲染是否正常：
- 若默认模式也异常，则属于游戏自身的渲染适配问题，请先排查游戏渲染逻辑。
- 若仅在 EmscriptenGLX 模式下异常，请联系我们协助排查。
Q3. 开启后性能没有提升甚至变差？
EmscriptenGLX 主要收益来自减少高频 GL 调用的跨边界开销，收益与游戏的渲染调用特征相关。如遇性能异常，请联系我们一起分析。