# Unity/团结引擎适配方案概述

美团小游戏支持将 Unity / 团结引擎（Tuanjie）开发的游戏转换为可运行在美团小游戏容器中的小游戏包。本章帮助你快速了解整体方案、适用范围与接入流程，再按需深入各专题文档。

# 一、技术原理

Unity 引擎的 BuildTarget 支持 WebGL 平台，WebGL 导出包基于 WebAssembly 技术运行。为了让导出包运行在美团小游戏环境，美团小游戏提供了三个阶段的支持：

开发阶段：提供平台能力的 C# SDK，帮助开发者快速对接登录、支付、广告、存储等平台能力。
导出阶段：提供 Unity 转换插件，对 Unity WebGL 胶水层进行适配，一键转换成小游戏包。
运行阶段：美团小游戏容器提供 WebAssembly 运行能力与底层接口支持，并在 Android / iOS / Web 三端运行。

# 二、适用游戏类目

考虑到游戏体积与逻辑复杂度，目前建议中轻度 2D / 3D 游戏进行转换，类目包括：

休闲：消除、答题、模拟经营、塔防、益智等
动作：跑酷、飞行射击、轻度 IO
棋牌：棋类、牌类
角色：卡牌、回合、策略

对 MMO / FPS 等重度游戏，需结合包体、内存与机型覆盖情况单独评估可行性。

# 三、接入流程

完整的接入旅程可分为五个阶段，建议按顺序推进：

阶段	目标	相关文档
一、兼容性评估	确认技术方案与引擎版本是否匹配游戏项目	本页「四、引擎版本」「五、能力支持」、环境准备
二、项目转换	得到可运行的 WebGL / 小游戏包	转换工具导出
三、平台能力接入	接入登录、支付、广告等平台能力	进阶能力
四、体验调优	达到可上线的启动与运行体验	启动性能优化、运行性能优化、WASM 代码分包、EmscriptenGLX 渲染模式
五、发布上线	提交发布并进行版本管理	发布上线

子系统适配（音视频与字体、网络通信、资源加载与部署）贯穿阶段二~四，按游戏实际使用到的能力查阅即可。

# 四、引擎版本

适配方案以团结引擎为主要支持目标，同时兼容传统 Unity 引擎。基于 WebAssembly 技术，转换插件理论上支持的引擎版本涵盖 Unity 2018~2022 与团结引擎；但并非每个小版本都经过充分验证，建议优先选择已验证的版本。

引擎版本	压缩纹理	说明
2018	仅 DXT，不支持 ETC2/ASTC	不支持设置 dpr 分辨率，不推荐新项目使用
2019	仅 DXT，不支持 ETC2/ASTC	老项目优先选择 2019 以上
2020	DXT/ETC2，不支持 ASTC	—
2021	全支持 DXT/ETC2/ASTC	编译体积更小、编译更快；EmscriptenGLX 需 2021.2+
2022（推荐）	全支持 DXT/ETC2/ASTC	更稳定的 MemoryProfiler，支持更多新渲染能力
团结引擎（推荐）	全支持 DXT/ETC2/ASTC	基于 2022.3，针对小游戏 / WebGL 环境进一步优化包体与内存

移动端压缩纹理：Android 使用 ETC2 / ASTC，iOS 使用 ASTC；引擎不支持移动端压缩纹理（如 2018~2020）时，请配合运行性能优化中的压缩纹理方案。

版本并非越新越好：新版本（尤其小版本）实现变更可能引入适配问题，建议尽量使用已有实际游戏验证的版本。

EmscriptenGLX 渲染模式需 Unity 2021.2+ 或团结引擎（普通转换不受此限制）；该模式目前处于内部测试阶段，需联系运营获取测试版本，详见该章。

# 五、能力支持