# minigame-unity-webgl-transform
**Repository Path**: wechat-minigame/minigame-unity-webgl-transform
## Basic Information
- **Project Name**: minigame-unity-webgl-transform
- **Description**: 团结/Unity 微信小游戏适配方案
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 368
- **Forks**: 0
- **Created**: 2022-08-27
- **Last Updated**: 2025-09-20
## Categories & Tags
**Categories**: Uncategorized
**Tags**: Unity, 微信小游戏, 游戏开发, 转换, 移植
## README
# 微信小游戏团结引擎/Unity适配方案
欢迎使用团结引擎/Unity小游戏适配方案，本方案为团结引擎设计，同时兼容传统Unity引擎，旨在**降低游戏转换到微信小游戏的开发成本**。基于 WebAssembly 技术，无需更换引擎与重写核心代码的情况下将原有游戏项目快速适配到微信小游戏。
### 支持引擎
本适配方案以团结引擎为主要支持目标，同时兼容传统Unity引擎。基于WebAssembly技术，具有非常宽泛的兼容性，转换插件理论上支持的引擎版本涵盖：Unity 2018~2022、[团结引擎](https://unity.cn/tuanjie/tuanjieyinqing)
### 方案特点
* 保持原引擎工具链与技术栈
* 无需重写游戏核心逻辑，支持大部分第三方插件
* 由转换工具与微信小游戏运行环境保证适配兼容，保持较高还原度
* 微信小游戏平台能力以C# SDK方式提供给开发者，快速对接平台开放能力
### 转换案例
| 我叫MT2(回合战斗) | 旅行串串(休闲) | 谜题大陆(SLG) | 热血神剑(MMO) |
| --- | --- | --- | --- |
| 
| 
| 
| 
|
[查阅更多转换案例](Design/ShowCase.md)
## 安装与使用
PackageManager(git安装URL): https://github.com/wechat-miniprogram/minigame-tuanjie-transform-sdk.git
UnityPackage：[下载地址](https://game.weixin.qq.com/cgi-bin/gamewxagwasmsplitwap/getunityplugininfo?download=1)
版本更新请查看[更新日志](CHANGELOG.md)，Unity/团结引擎详细安装请查阅[SDK安装指引](Design/SDKInstaller.md)
- 请查阅[推荐引擎版本](Design/UnityVersion.md)，安装时选择WebGL组件
- 前往[微信开发者工具下载](https://developers.weixin.qq.com/miniprogram/dev/devtools/stable.html)安装Stable版开发者工具【注意：为保证稳定性，请勿使用小游戏版 Minigame Build】
- 查阅[小游戏开发者文档-快速上手](https://developers.weixin.qq.com/minigame/dev/guide/)创建小游戏类目应用
- 登录[MP微信公众平台](https://mp.weixin.qq.com)，能力地图-生产提效包-快适配，开通使用
- 查阅[快速开始：转换工具导出微信小游戏](Design/Transform.md)进行小游戏导出转换
## 文档目录结构
### 基本
- [安装与使用](Design/SDKInstaller.md)
- [入门指南](Design/Guide.md)
- [快速开始](Design/Transform.md)
- [优秀案例](Design/ShowCase.md)
- [更新日志](CHANGELOG.md)
### 方案概述与兼容性
- [技术原理](Design/Summary.md)
- [兼容性评估](Design/Evaluation.md)
- [技术常见问题QA](Design/DevelopmentQAList.md)
### 性能优化
#### 性能优化总览
- [性能优化总览](Design/PerfOptimization.md)
- [性能优化评估标准](Design/PerfMeasure.md)
#### 启动性能
- [提升游戏启动速度](Design/StartupOptimization.md)
- [启动流程与时序](Design/Startup.md)
- [使用 Loader 进行游戏加载](Design/UsingLoader.md)
- [资源按需加载概述](Design/ResourcesLoading.md)
- [使用 AssetBundle 按需加载](Design/UsingAssetBundle.md)
- [使用 Addressable 按需加载](Design/UsingAddressable.md)
- [使用 AutoStreaming 按需加载](Design/InstantGameGuide.md)
- [定制启动封面](Design/CustomLoading.md)
- [设计启动剧情](Design/LaunchOpera.md)
- [使用预下载功能](Design/UsingPreload.md)
- [首场景启动优化](Design/FirstSceneOptimization.md)
- [使用代码分包工具](Design/WasmSplit.md)
- [启动留存数据上报统计](Design/ReportStartupStat.md)
- [最佳实践检测工具](Design/PerformanceMonitor.md)
- [微信系统字体](Design/WXFont.md)
#### 运行性能
- [优化 Unity WebGL 的运行性能](Design/OptimizationPerformence.md)
- [Android CPU Profiler 性能调优](Design/AndroidProfile.md)
- [Unity Profiler 性能调优](Design/UnityProfiler.md)
- [优化 Unity WebGL 的内存](Design/OptimizationMemory.md)
- [ProfilingMemory分析内存](Design/UsingMemoryProfiler.md)
- [压缩纹理优化](Design/CompressedTexture.md)
- [资源优化工具与建议](Design/AssetOptimization.md)
- [iOS高性能 与 高性能+ 模式](Design/iOSOptimization.md)
- [优化Unity WebGL的渲染性能](Design/RenderOptimization.md)
- [EmscriptenGLX渲染模式](Design/EmscriptenGLX.md)
- [定制微信小游戏的 URP 管线](Design/CustomURP.md)
- [WebGL2.0渲染支持说明](Design/WebGL2.md)
- [性能深度分析工具](Design/DeepProfileTool.md)
- [高精度时间](Design/HighPreciseTime.md)
- [优化实战: Particle Simulate Budget方案](Design/ParticleBudget.md)
- [微信小游戏功耗分析指引 -- iOS 篇](Design/PowerPerf-iOS.md)
- [Shader 异步 Warmup](Design/AsyncShaderWarmup.md)
- [iOS Metal 渲染](Design/iOSMetal.md)
### 版本更新与资源部署
- [小游戏资源部署](Design/DataCDN.md)
- [小游戏资源缓存](Design/FileCache.md)
- [小游戏版本更新](Design/Update.md)
### 能力适配
- [WX SDK 平台能力适配](Design/WX_SDK.md)
- [音频视频适配](Design/AudioAndVideo.md)
- [屏幕适配](Design/fixScreen.md)
- [输入法适配](Design/InputAdaptation.md)
- [排行榜与微信关系数据](Design/OpenData.md)
- [后端服务指引](Design/BackendServiceStartup.md)
- [网络通信适配](Design/UsingNetworking.md)
- [使用水印保护代码包安全](Design/wasmWaterMark.md)
- [配置构建模板](Design/BuildTemplate.md)
- [实时预览工具](Design/WechatPreview.md)
### 调试与异常处理
- [开发错误调试与排查](Design/DebugAndException.md)
- [现网错误日志上报与排查](Design/IssueForProduction.md)
- [MiniGameConfig.asset 说明](Design/AssetDescription.md)
### 其他
- [技术常见问题QA](Design/DevelopmentQAList.md)
- [问题反馈与联系我们](Design/IssueAndContact.md)
- [技术沙龙](Design/Salon.md)