README.md

Unity WebGL 微信小游戏适配方案(公测)

欢迎使用 Unity WebGL 小游戏适配(转换)方案，本方案设计目的是降低 Unity 游戏转换到微信小游戏的开发成本。基于WebAssembly技术，无需更换Unity引擎与重写核心代码的情况下将原有游戏项目适配到微信小游戏。

• 若图片无法显示，请访问gitee项目地址

方案特点

• 保持原引擎工具链与技术栈
• 无需重写游戏核心逻辑，支持大部分第三方插件
• 由转换工具与微信小游戏运行环境保证适配兼容，保持较高还原度
• 微信小游戏平台能力以C# SDK方式提供给开发者，快速对接平台开放能力

转换案例

我叫MT2(回合战斗)	旅行串串(休闲)	谜题大陆(SLG)	热血神剑(MMO)

• 更多转换案例

安装与使用

下载 Unity插件，并导入至游戏项目中，版本更新请查看更新日志

• 请查阅推荐引擎版本，安装时选择WebGL组件
• 前往微信开发者工具下载安装Stable版开发者工具【注意：为保证稳定性，请勿使用小游戏版 Minigame Build】
• 查阅小游戏开发者文档-快速上手创建小游戏类目应用
• 登录MP微信公众平台，能力地图-生产提效包-快适配，开通使用
• 查阅快速开始：转换工具导出微信小游戏进行小游戏导出转换

文档总览

• Unity WebGL微信小游戏转换指南

方案概述与兼容性

• 技术原理
• 兼容性评估
• 推荐引擎版本
• 更多转换案例
• 技术常见问题QA

性能优化

• 性能优化总览

• 性能评估标准

• 启动性能

  • 提升 Unity WebGL 游戏启动速度
  • 启动流程与时序
  • 使用 Loader 进行游游戏加载
  • 资源按需加载概述
  • 使用 AssetBundle 进行资源按需加载
  • 使用 Addressable 进行资源按需加载
  • 使用 AutoStreaming 进行资源按需加载
  • 定制启动封面
  • 使用预下载功能
  • 首场景启动优化
  • 使用代码分包工具
  • 启动留存数据上报统计
  • 最佳实践检测工具
  • 微信系统字体

• 运行性能

  • 优化Unity WebGL的运行性能
  • 使用 Android CPU Profiler 性能调优
  • 使用 Unity Profiler 性能调优
  • 优化Unity WebGL的内存
  • 使用ProfilingMemory分析内存
  • 压缩纹理优化
  • 资源优化工具与建议
  • iOS高性能模式
  • 优化Unity WebGL的渲染性能
  • 定制微信小游戏的 URP 管线
  • WebGL2.0渲染支持说明

版本更新与资源部署

• 小游戏资源部署
• 小游戏资源缓存
• 小游戏版本更新

能力适配

• WX SDK 平台能力适配
• 屏幕适配
• 输入法适配
• 排行榜与微信关系数据
• 后端服务指引
• 网络通信适配
• 使用水印保护代码包安全

调试与异常

• 开发错误调试与排查
• 现网错误日志上报与排查

问题反馈

• 问题反馈与联系我们