1. 个人主体做微信小游戏先搞清楚这几点1.1 个人主体到底能不能做版号是怎么回事先说结论个人主体完全可以做 Unity 微信小游戏而且如果游戏本身不涉及内购、不做虚拟支付那么在免版号这条路上是走得通的。很多刚入行的朋友一听到版号两个字就头大觉得个人开发者根本没机会其实这里有个关键区别要说清楚。微信小游戏上架目前分两类一类是涉及付费的商业游戏比如带内购、道具、月卡这些那确实需要版号还得有软件著作权这个门槛对个人主体来说基本绕不过去另一类是不含虚拟支付功能的休闲小游戏、工具类小游戏可以通过个人主体 免费游戏的方式发布不需要提交版号只做内容审核和基础资质审核。我们这篇文章讲的就是后者的完整路径。所以免版号不是钻空子而是微信小游戏平台规则里实际存在的一条个人开发者的合法通道。你要做的是保证游戏里没有任何需要付费解锁、充值、购买的内容连看广告解锁这类广告变现也要看平台具体要求不同时期审核尺度会有差异但纯免费、纯广告展示的模式是目前个人主体最稳妥的选择。另外要说一句即便免版号个人主体仍然要做小程序账号注册和微信认证这两步是绕不开的。认证需要提交身份证信息部分地区或特殊情况可能需要经营者信息但整体流程比企业主体简单太多了。个人主体的限制也很明确不能开通微信支付、不能做虚拟支付、部分类目受限制但如果是做免费的小游戏、工具类玩法这些限制几乎不构成障碍。1.2 Unity项目转微信小游戏方案怎么选Unity 项目跑进微信小游戏环境本质上不是打包出 exe那种思路而是把 Unity 的渲染和逻辑跑在小游戏容器里。目前主流方案有两条路一条是官方的 Unity 微信小游戏适配方案通过官方提供的 minigame 插件把 Unity WebGL 导出产物进一步改造成小游戏可识别的包体另一条是纯手写原生小游戏绕开 Unity 的重量级引擎只把核心玩法用 TypeScript 重新实现一遍。对绝大多数人来说第一条路才是正解。原因很简单Unity 项目的游戏逻辑、美术资源、物理系统、动画系统全部复用不需要重写业务代码。你需要做的是在 Unity 里做一次面向 WebGL 的适配然后导出、转换、上传。第二条路适合什么场景呢如果项目本身的 Unity 依赖非常浅只是用了 Unity 的 2D Sprite 和简单脚本那手写原生可能是性能和包体上的最优解但工作量摆在那里不是三五天能搞完的。从我的实操经验看Unity 转微信小游戏官方插件是目前最省力的方案社区里也已经跑通了几千个案例。你不需要从零搭建适配层官方插件把 Unity 的 WebGL 构建产物和微信小游戏环境之间的桥接逻辑处理了大部分包括资源加载、内存管理、屏幕适配、输入事件转换这些脏活。你要做的是把插件配置好把 Unity 项目的构建目标切到 WebGL然后处理导出后的转换和上传。2. 环境准备与工具链搭建2.1 Unity 版本与导出方案确认在做任何转换之前先确认你的 Unity 版本。这不是废话版本差一两个小版本踩的坑能差出好几倍。理论上 Unity 2021 之后的 LTS 版本对 WebGL 的支持都比较稳我个人建议至少用 Unity 2021.3 LTS有条件直接上 2022.3 LTS 或 2023.2 以上版本。太老的版本2019、2020在 WebGL 导出的稳定性和内存控制上都有明显短板特别是大项目内存峰值经常压不下来后面你会被内存崩溃逼疯的。还要确认你的项目有没有用到一些 WebGL 不支持的特性。最典型的坑是多线程。Unity WebGL 默认不支持 .NET 多线程如果你的项目开了 Job System、Thread 或者 ECS 相关的东西在 WebGL 导出时会报一堆编译错误或者运行时诡异崩溃。另一大坑是 Socket 相关WebGL 环境没有原生 TCP/UDP Socket如果你的项目用了网络库做实时通信那要么改用 WebSocket 方案要么就要规划好在小游戏环境里走 HTTPS 接口。还有一个容易被忽略的点Unity 的编译目标要切成 IL2CPP。WebGL 导出必须使用 IL2CPPMono 不支持 WebGL。你的代码里如果有 AOT 相关限制、反射用得过于奔放在切到 IL2CPP 后会出现一些奇怪问题比如反射拿不到字段、类型裁剪导致“找不到类型”等。这个在项目早期就切一次 IL2CPP 跑通绝对比最后转换时才发现要省心得多。2.2 微信开发者工具与小游戏环境微信开发者工具是你调试和提交代码的核心工具PC 上装一个稳定版就行。打开工具后前端界面是小程序模式但你要做的是小游戏所以需要在小程序项目的创建流程里选择小游戏类型。小游戏和小程序的工程结构不同小游戏根目录下需要一个 game.json小程序的则是 app.json千万别搞混。在工具里你可以用手机扫码预览也可以直接模拟器调试。我强烈建议多用手-机真机预览因为模拟器环境和真实手机的 WebGL 表现差异很大特别是 GPU 驱动、内存限制、指纹设备差异这些问题只有真机能复现。工具还提供了一个真机调试模式可以在手机上跑一个带调试面板的版本查看 console 日志和网络请求这个是排查疑难杂症的神器。另外微信开发者工具的详情-本地设置里有个启用云开发的按钮如果你后续要用云函数、云存储来存排行榜数据可以提前开通。但对纯 Unity 项目来说排行榜一般用开放数据域做不一定依赖云开发这个后面细讲。2.3 转换工具链的安装与配置Unity 转微信小游戏的官方方案是在 Unity 项目中安装一个叫Minigame的插件微信搜索Unity 微信小游戏即可找到官方文档和下载地址。这个插件在 Unity 的 Package Manager 里可以搜到也可以直接 git 地址安装。安装完成之后菜单栏里会出现一个微信小游戏的入口点进去就能看到导出、转换、上传等一系列操作。在配置插件之前要把 Unity 的 Build Target 切到 WebGL。注意 WebGL 模块如果没有安装需要先去 Unity Hub 的模块管理里勾选 WebGL Build Support 下载安装。插件本身会读取 Unity 的 WebGL 构建产物所以这个前置条件必须满足。插件的高级设置里有一些关键项。比如压缩格式默认可能是 Brotli但小游戏环境对 Brotli 的支持要看基础库版本建议用 Gzip 或 Disabled 来避免兼容问题再比如数据缓存开启 AssetBundle 缓存可以大幅降低加载时间但会占用用户手机存储空间还有内存上限这个跟具体设备强相关建议用默认值真机测试后按需调整。这些配置没有绝对正确需要跟着真机调试数据走。3. Unity 转微信小游戏核心实操3.1 项目预处理与工程调整先花一晚上整理你的工程别看是大项目小项目都躲不过。第一件要做的事是清理无用资源。Unity 项目经过几个月的迭代Project 面板里会躺着一堆没人用的 Texture、AudioClip、Prefab还有被历史版本丢弃的代码。这些资源不会自动从打包内容里消失如果你不手动清理它们会被 WebGL 的 AssetBundle 方案全部打进去包体瞬间大几 MB加载时间和内存占用都跟着爆炸。第二件事是调整 Player Settings。在 Other Settings 里把 Scripting Backend 切到 IL2CPP把 API Compatibility Level 调到 .NET Standard 2.1部分库如果要求 .NET Framework那就得评估替换库了。Resolution 相关设置里默认分辨率用横屏还是竖屏要跟你小游戏在 game.json 里配置的方向保持一致不然转换后画面方向会出问题。第三件事是删掉所有不支持 WebGL 的代码和插件。比如本地数据库 SQLite 方案、原生文件读写插件、Obfuscator 混淆工具这些在 WebGL 环境下要么编译失败要么运行时抛异常。保险做法是在 Unity 里新建一个 WebGL 的编译宏分支把涉险代码用 #if !UNITY_WEBGL 包起来而不是直接把代码删掉方便以后多端复用。3.2 WebGL 导出与转换流程工程预处理完成后从 Unity 菜单栏点击Build And Run把 WebGL 包构建出来。构建产物会是一个文件夹里面有 index.html、js、wasm、data 等文件。此时这个包还不能直接跑在微信里需要通过插件把 Unity 的加载入口和微信小游戏的启动流程对接起来。接着回到插件窗口点击导出小游戏或转换按钮插件会自动读取刚才的 WebGL 构建产物生成一个小游戏可识别的目录结构。这个目录里会多出 game.json、game.js、project.config.json 等小游戏特有文件同时 Unity 的 wasm 文件和资源会被重新处理、压缩和分包。这里有个细节转换后的包体会放在小游戏目录的 unity 子目录下而 Unity 的资源加载路径也会被自动改写不需要你手动干预。转换完成后用微信开发者工具打开这个生成的小游戏目录先在工具里跑一遍编译看有没有底层报错。常见的问题是 wasm 文件太大导致编译超时或者初次加载时 WebAssembly 编译时间过长工具会在模拟器里弹一个代码包解析失败之类的提示。这时候需要回到 Unity 项目里调分包策略把主包压缩到 20MB 以内微信小游戏主包限制其他资源走子包加载。3.3 登录、开放数据域与广告接入很多人转完包才发现Unity 里的登录系统在小游戏环境里完全不可用。因为小游戏没有传统网页的 cookie 和 session也没法直接调微信登录之外的身份体系。最标准的做法是先在小游戏的入口脚本里调用 wx.login 拿到 code然后传给自己的后端服务器换取 openid 和 session_key之后的用户身份都靠这个 openid 来识别。Unity 端逻辑怎么拿到这个 openid 呢通过插件提供的 JSBridge 机制在 C# 里调用一个方法让小游戏环境执行 wx 接口然后把结果回传给 C# 的回调函数。开放数据域是另一种更特殊的东西。微信小游戏要求好友排行榜这类社交数据必须在开放数据域里渲染开放数据域是一个独立于 Unity 主游戏的小舞台它有自己的 JS 代码和渲染上下文无法直接访问 Unity 主程序的资源。这意味着 Unity 里的 UI 排行榜思路不能直接搬过来你得另外写一套 TypeScript Canvas 的排行榜界面让它在开放数据域里独立渲染然后用插件提供的接口把玩家得分数据传进去。第一次接触会觉得很绕但只要你理解了主域和开放数据域物理隔离这件事思路就顺了。广告接入相对简单。在小游戏目录里用 wx.createBannerAd 或 wx.createRewardedVideoAd 创建广告实例然后在 Unity C# 里通过 JSBridge 调用这些接口就可以在对应时机弹出广告。重要的是要在代码里处理广告加载失败的回调微信广告不一定每次都加载成功失败时要优雅降级比如提示用户稍后再看而不是直接报错。3.4 必踩的坑内存、分包、加载优化我见过太多项目倒在这三道坎上提前说清楚能帮你少熬几个通宵。第一道坎是内存。WebGL 环境的最大可用内存通常被限制在 2GB 甚至更低手机上更夸张iOS 上经常只有几百 MB。Unity 项目如果纹理动辄 2048x2048、网格几千个顶点那么在手机上很容易触发内存崩溃表现为游戏闪退、黑屏、或者微信提示渲染进程无响应。解决方案分几个层面纹理压缩格式优先用 ASTC针对移动端压缩质量调到中低档关掉不必要的实时阴影和 HDR能池化的对象别频繁实例化和销毁AssetBundle 加载后不用的资源及时 Unload。你需要在 Unity Profiler 里对着内存曲线一点一点抠没有捷径。第二道坎是包体与加载速度。微信小游戏主包限制是 20MB超过部分必须拆分包。Unity 转出来的包如果纹理和音频不压缩动不动就几百 MB那就别想着一次加载完。插件支持 AssetBundle 分包你需要把游戏划分为几个逻辑模块比如登录大厅和战斗场景分开打包进入对应场景时再动态加载对应包。配合 CDN 预下载和本地缓存可以实现场景秒切。第三道坎是 WebAssembly 编译时间。首次加载小游戏时wasm 需要在设备上编译性能差的手机可能要等好几秒甚至十几秒。这个不能用技术手段完全消除但可以通过分包机制让首屏必要代码体积尽量小同时开启 wasm 的流式编译微信工具里可以配置 enable-webgl 相关参数能在一定程度上摊平编译阻塞。加载界面也要做好别让用户以为游戏卡死了。4. 个人主体发布全流程4.1 小程序账号注册与主体认证发布前必须在微信公众平台注册一个小游戏账号。注册时账号类型选择小游戏主体类型选择个人。这里有个关键提示个人主体的注册身份证信息务必和后续提交审核时保持一致姓名和身份证号错了会被打回重新认证整个流程会多花好几天。注册完成后会进入微信认证流程。个人主体认证相对简单不需要对公账户打款验证只需上传身份证正反面照片按指引做人脸识别或短信验证。这里我要吐槽一句微信认证每年需要续期费用视当前政策而定但个人主体认证费用比企业主体低。认证通过后你的账号主体就是个人的个人主体在功能权限上会有一定的限制比如无法开通支付、部分类目不可选但对免费小游戏来说完全够用。接下来要完善 AppID 和 AppSecret。在公众平台的后台开发管理-开发设置里可以拿到 AppID这个就是后续 Unity 插件上传代码时要用到的标识。AppSecret 属于敏感信息不要暴露在客户端代码里如果只是用微信开发者工具的自动上传功能工具会引导你完成登录授权不需要在工单里手动填 AppSecret。4.2 上传代码、提审与发布代码上传有两种方式。一种是在微信开发者工具里点击右上角的上传按钮填写版本号和备注后上传另一种是从 Unity 插件的上传入口直接提交两者本质一样。上传成功后去公众平台的后台版本管理里能看到刚上传的版本点击提交审核即可。提审阶段有几个高频被拒原因提前避开。第一是首包超限也就是主包超过了 20MB 限制第二是内容含红包/抽奖/涉黄涉政等违规内容这个不多说任何擦边球都别碰第三是没有隐私政策个人主体做小游戏也需要在设置里补充隐私保护指引说明你的程序如何收集、存储、使用用户信息第四是类目不符个人主体可选类目里如果找不到小游戏这个类目就选工具-效率之类的相近类目然后在描述里说明这是一个游戏类应用审核员会按实际情况判断。审核时间一般 1-3 个工作日也有当天出结果的取决于你提交的时间段和当时的审核队列。审核通过后后台会出现发布按钮点击后游戏就正式对小游戏用户可见了。这里提醒一下发布不是终点你仍然可以在后台更新版本、发布新版本每次发新版都要重新提审。4.3 发布后的数据监控与迭代游戏上线后你第一时间要关注的是首日崩溃率和次留。在公众平台的数据分析里可以查看用户详细的行为数据包括打开次数、新用户数、留存率等。崩溃率高的话优先排查内存问题特别是低端安卓机很多 Unity 转小游戏的包在高端 iPhone 上稳如狗到了低端安卓上就闪退基本就是内存超限或者 GPU 兼容性问题。另一个重要的监控维度是加载耗时。小游戏包体大、wasm 编译时间长直接导致用户打开时白屏很久。你可以在游戏代码里打点统计 load 完成的时间点如果平均值超过 5 秒就该认真做分包和压缩优化了。用户对首屏加载的耐心非常有限白屏超过 3 秒就会流失相当一部分人。数据反馈驱动迭代的方向一般是看用户卡在哪一关流失看哪个关卡点击率低看广告展示量是否过高影响体验。Unity 项目本身的数据统计可以通过 JSBridge 上报到微信后台也可以用第三方统计平台但注意隐私合规收集用户数据前要弹出隐私说明。5. 常见问题排查实录5.1 转换失败类问题转换失败这个问题出现过很多次大多数是配置层面的原因。比较典型的有Unity 版本没有装 IL2CPP 模块、插件版本和 Unity 版本不兼容、导出目录路径里有中文字符或空格导致插件脚本解析失败。这类问题解法很简单先仔细看报错日志里的关键行再回 Unity 里逐项排查。还有一个隐蔽原因是杀毒软件或 Windows Defender 拦截了插件写文件导致转换一半就失败关闭实时防护再转一次往往就好了。另一个高频问题是导出后 JS 报错 Uncaught TypeError: Cannot read property unityInstance of undefined。这个一般是因为 WebGL 的 index.html 模板被改动过或者插件没有正确识别 Unity 的加载器。用默认模板重新导出一次不要手工改 index.html问题就没必要存在。5.2 运行异常类问题运行期最磨人的是白屏。引起白屏的原因太多了Unity 侧加载主场景失败、wasm 初始化超时、资源路径错误、微信基础库版本太旧无法支持 WebGL 等等。排查思路是先打开微信开发者工具的真机调试模式看 console 日志有没有报错如果真机报错但模拟器正常优先怀疑内存占用过高导致 App 被杀。还有一个非常容易误判的问题是声音播放失败。Unity 的 AudioSource 在小游戏环境里首次播放需要在用户点击或触碰后触发因为微信对自动播放有严格限制防止页面一打开就放声音。处理方法在游戏启动后引导用户点击一次屏幕在点击回调里创建一个已加载的 AudioSource 并播放一个极短的无声音频把音频上下文激活后续所有声音才正常。很多人声音时有时无就是没处理这个自动播放策略。5.3 审核被拒类问题被拒之后不用慌后台会给出具体的拒绝理由多数是缺少隐私政策类目不合含敏感内容。其中隐私政策几乎是个人主体首次提交最容易踩的坑因为很多人觉得个人开发的小游戏不需要隐私合规但平台要求的就是任何收集用户信息的行为包括微信登录时获取头像昵称都必须声明。在公众平台设置里补充隐私保护指引说明你收集哪些信息、如何存储、如何使用通过后再提审就会顺畅很多。还有一种被拒理由是内容低俗或涉及现金奖励诱导。小游戏里别搞什么签到送现金、分享得红包这种擦边玩法个人主体在合规审核上更容易被从严。老老实实做游戏内容、广告变现审核通过率会有保障。5.4 实际操作中的两三句体己话我见过太多人死在我项目跑通了但转换后手机上一看就崩。这里两句话第一句是一定要在早期做一次完整链路的真机验证别等项目做完了才去搞小游戏适配第二句是合理的取舍比堆功能重要Unity 项目里很多功能在小游戏端并不必要砍掉它们不只是减包体更是减崩溃率。根据我个人经验从 Unity 项目到微信小游戏上线如果轻车熟路一个小项目一周内可以跑通全流程如果第一次做给自己留出三周时间论调会比较合理。过程中最值得投入精力的不是打包而是真机调试和内存优化这两项做踏实了后面的路基本顺了。希望这篇流程梳理能让你少踩几个我踩过的坑早点把游戏搬上微信。
1. 个人主体做微信小游戏先搞清楚这几点1.1 个人主体到底能不能做版号是怎么回事先说结论个人主体完全可以做 Unity 微信小游戏而且如果游戏本身不涉及内购、不做虚拟支付那么在免版号这条路上是走得通的。很多刚入行的朋友一听到版号两个字就头大觉得个人开发者根本没机会其实这里有个关键区别要说清楚。微信小游戏上架目前分两类一类是涉及付费的商业游戏比如带内购、道具、月卡这些那确实需要版号还得有软件著作权这个门槛对个人主体来说基本绕不过去另一类是不含虚拟支付功能的休闲小游戏、工具类小游戏可以通过个人主体 免费游戏的方式发布不需要提交版号只做内容审核和基础资质审核。我们这篇文章讲的就是后者的完整路径。所以免版号不是钻空子而是微信小游戏平台规则里实际存在的一条个人开发者的合法通道。你要做的是保证游戏里没有任何需要付费解锁、充值、购买的内容连看广告解锁这类广告变现也要看平台具体要求不同时期审核尺度会有差异但纯免费、纯广告展示的模式是目前个人主体最稳妥的选择。另外要说一句即便免版号个人主体仍然要做小程序账号注册和微信认证这两步是绕不开的。认证需要提交身份证信息部分地区或特殊情况可能需要经营者信息但整体流程比企业主体简单太多了。个人主体的限制也很明确不能开通微信支付、不能做虚拟支付、部分类目受限制但如果是做免费的小游戏、工具类玩法这些限制几乎不构成障碍。1.2 Unity项目转微信小游戏方案怎么选Unity 项目跑进微信小游戏环境本质上不是打包出 exe那种思路而是把 Unity 的渲染和逻辑跑在小游戏容器里。目前主流方案有两条路一条是官方的 Unity 微信小游戏适配方案通过官方提供的 minigame 插件把 Unity WebGL 导出产物进一步改造成小游戏可识别的包体另一条是纯手写原生小游戏绕开 Unity 的重量级引擎只把核心玩法用 TypeScript 重新实现一遍。对绝大多数人来说第一条路才是正解。原因很简单Unity 项目的游戏逻辑、美术资源、物理系统、动画系统全部复用不需要重写业务代码。你需要做的是在 Unity 里做一次面向 WebGL 的适配然后导出、转换、上传。第二条路适合什么场景呢如果项目本身的 Unity 依赖非常浅只是用了 Unity 的 2D Sprite 和简单脚本那手写原生可能是性能和包体上的最优解但工作量摆在那里不是三五天能搞完的。从我的实操经验看Unity 转微信小游戏官方插件是目前最省力的方案社区里也已经跑通了几千个案例。你不需要从零搭建适配层官方插件把 Unity 的 WebGL 构建产物和微信小游戏环境之间的桥接逻辑处理了大部分包括资源加载、内存管理、屏幕适配、输入事件转换这些脏活。你要做的是把插件配置好把 Unity 项目的构建目标切到 WebGL然后处理导出后的转换和上传。2. 环境准备与工具链搭建2.1 Unity 版本与导出方案确认在做任何转换之前先确认你的 Unity 版本。这不是废话版本差一两个小版本踩的坑能差出好几倍。理论上 Unity 2021 之后的 LTS 版本对 WebGL 的支持都比较稳我个人建议至少用 Unity 2021.3 LTS有条件直接上 2022.3 LTS 或 2023.2 以上版本。太老的版本2019、2020在 WebGL 导出的稳定性和内存控制上都有明显短板特别是大项目内存峰值经常压不下来后面你会被内存崩溃逼疯的。还要确认你的项目有没有用到一些 WebGL 不支持的特性。最典型的坑是多线程。Unity WebGL 默认不支持 .NET 多线程如果你的项目开了 Job System、Thread 或者 ECS 相关的东西在 WebGL 导出时会报一堆编译错误或者运行时诡异崩溃。另一大坑是 Socket 相关WebGL 环境没有原生 TCP/UDP Socket如果你的项目用了网络库做实时通信那要么改用 WebSocket 方案要么就要规划好在小游戏环境里走 HTTPS 接口。还有一个容易被忽略的点Unity 的编译目标要切成 IL2CPP。WebGL 导出必须使用 IL2CPPMono 不支持 WebGL。你的代码里如果有 AOT 相关限制、反射用得过于奔放在切到 IL2CPP 后会出现一些奇怪问题比如反射拿不到字段、类型裁剪导致“找不到类型”等。这个在项目早期就切一次 IL2CPP 跑通绝对比最后转换时才发现要省心得多。2.2 微信开发者工具与小游戏环境微信开发者工具是你调试和提交代码的核心工具PC 上装一个稳定版就行。打开工具后前端界面是小程序模式但你要做的是小游戏所以需要在小程序项目的创建流程里选择小游戏类型。小游戏和小程序的工程结构不同小游戏根目录下需要一个 game.json小程序的则是 app.json千万别搞混。在工具里你可以用手机扫码预览也可以直接模拟器调试。我强烈建议多用手-机真机预览因为模拟器环境和真实手机的 WebGL 表现差异很大特别是 GPU 驱动、内存限制、指纹设备差异这些问题只有真机能复现。工具还提供了一个真机调试模式可以在手机上跑一个带调试面板的版本查看 console 日志和网络请求这个是排查疑难杂症的神器。另外微信开发者工具的详情-本地设置里有个启用云开发的按钮如果你后续要用云函数、云存储来存排行榜数据可以提前开通。但对纯 Unity 项目来说排行榜一般用开放数据域做不一定依赖云开发这个后面细讲。2.3 转换工具链的安装与配置Unity 转微信小游戏的官方方案是在 Unity 项目中安装一个叫Minigame的插件微信搜索Unity 微信小游戏即可找到官方文档和下载地址。这个插件在 Unity 的 Package Manager 里可以搜到也可以直接 git 地址安装。安装完成之后菜单栏里会出现一个微信小游戏的入口点进去就能看到导出、转换、上传等一系列操作。在配置插件之前要把 Unity 的 Build Target 切到 WebGL。注意 WebGL 模块如果没有安装需要先去 Unity Hub 的模块管理里勾选 WebGL Build Support 下载安装。插件本身会读取 Unity 的 WebGL 构建产物所以这个前置条件必须满足。插件的高级设置里有一些关键项。比如压缩格式默认可能是 Brotli但小游戏环境对 Brotli 的支持要看基础库版本建议用 Gzip 或 Disabled 来避免兼容问题再比如数据缓存开启 AssetBundle 缓存可以大幅降低加载时间但会占用用户手机存储空间还有内存上限这个跟具体设备强相关建议用默认值真机测试后按需调整。这些配置没有绝对正确需要跟着真机调试数据走。3. Unity 转微信小游戏核心实操3.1 项目预处理与工程调整先花一晚上整理你的工程别看是大项目小项目都躲不过。第一件要做的事是清理无用资源。Unity 项目经过几个月的迭代Project 面板里会躺着一堆没人用的 Texture、AudioClip、Prefab还有被历史版本丢弃的代码。这些资源不会自动从打包内容里消失如果你不手动清理它们会被 WebGL 的 AssetBundle 方案全部打进去包体瞬间大几 MB加载时间和内存占用都跟着爆炸。第二件事是调整 Player Settings。在 Other Settings 里把 Scripting Backend 切到 IL2CPP把 API Compatibility Level 调到 .NET Standard 2.1部分库如果要求 .NET Framework那就得评估替换库了。Resolution 相关设置里默认分辨率用横屏还是竖屏要跟你小游戏在 game.json 里配置的方向保持一致不然转换后画面方向会出问题。第三件事是删掉所有不支持 WebGL 的代码和插件。比如本地数据库 SQLite 方案、原生文件读写插件、Obfuscator 混淆工具这些在 WebGL 环境下要么编译失败要么运行时抛异常。保险做法是在 Unity 里新建一个 WebGL 的编译宏分支把涉险代码用 #if !UNITY_WEBGL 包起来而不是直接把代码删掉方便以后多端复用。3.2 WebGL 导出与转换流程工程预处理完成后从 Unity 菜单栏点击Build And Run把 WebGL 包构建出来。构建产物会是一个文件夹里面有 index.html、js、wasm、data 等文件。此时这个包还不能直接跑在微信里需要通过插件把 Unity 的加载入口和微信小游戏的启动流程对接起来。接着回到插件窗口点击导出小游戏或转换按钮插件会自动读取刚才的 WebGL 构建产物生成一个小游戏可识别的目录结构。这个目录里会多出 game.json、game.js、project.config.json 等小游戏特有文件同时 Unity 的 wasm 文件和资源会被重新处理、压缩和分包。这里有个细节转换后的包体会放在小游戏目录的 unity 子目录下而 Unity 的资源加载路径也会被自动改写不需要你手动干预。转换完成后用微信开发者工具打开这个生成的小游戏目录先在工具里跑一遍编译看有没有底层报错。常见的问题是 wasm 文件太大导致编译超时或者初次加载时 WebAssembly 编译时间过长工具会在模拟器里弹一个代码包解析失败之类的提示。这时候需要回到 Unity 项目里调分包策略把主包压缩到 20MB 以内微信小游戏主包限制其他资源走子包加载。3.3 登录、开放数据域与广告接入很多人转完包才发现Unity 里的登录系统在小游戏环境里完全不可用。因为小游戏没有传统网页的 cookie 和 session也没法直接调微信登录之外的身份体系。最标准的做法是先在小游戏的入口脚本里调用 wx.login 拿到 code然后传给自己的后端服务器换取 openid 和 session_key之后的用户身份都靠这个 openid 来识别。Unity 端逻辑怎么拿到这个 openid 呢通过插件提供的 JSBridge 机制在 C# 里调用一个方法让小游戏环境执行 wx 接口然后把结果回传给 C# 的回调函数。开放数据域是另一种更特殊的东西。微信小游戏要求好友排行榜这类社交数据必须在开放数据域里渲染开放数据域是一个独立于 Unity 主游戏的小舞台它有自己的 JS 代码和渲染上下文无法直接访问 Unity 主程序的资源。这意味着 Unity 里的 UI 排行榜思路不能直接搬过来你得另外写一套 TypeScript Canvas 的排行榜界面让它在开放数据域里独立渲染然后用插件提供的接口把玩家得分数据传进去。第一次接触会觉得很绕但只要你理解了主域和开放数据域物理隔离这件事思路就顺了。广告接入相对简单。在小游戏目录里用 wx.createBannerAd 或 wx.createRewardedVideoAd 创建广告实例然后在 Unity C# 里通过 JSBridge 调用这些接口就可以在对应时机弹出广告。重要的是要在代码里处理广告加载失败的回调微信广告不一定每次都加载成功失败时要优雅降级比如提示用户稍后再看而不是直接报错。3.4 必踩的坑内存、分包、加载优化我见过太多项目倒在这三道坎上提前说清楚能帮你少熬几个通宵。第一道坎是内存。WebGL 环境的最大可用内存通常被限制在 2GB 甚至更低手机上更夸张iOS 上经常只有几百 MB。Unity 项目如果纹理动辄 2048x2048、网格几千个顶点那么在手机上很容易触发内存崩溃表现为游戏闪退、黑屏、或者微信提示渲染进程无响应。解决方案分几个层面纹理压缩格式优先用 ASTC针对移动端压缩质量调到中低档关掉不必要的实时阴影和 HDR能池化的对象别频繁实例化和销毁AssetBundle 加载后不用的资源及时 Unload。你需要在 Unity Profiler 里对着内存曲线一点一点抠没有捷径。第二道坎是包体与加载速度。微信小游戏主包限制是 20MB超过部分必须拆分包。Unity 转出来的包如果纹理和音频不压缩动不动就几百 MB那就别想着一次加载完。插件支持 AssetBundle 分包你需要把游戏划分为几个逻辑模块比如登录大厅和战斗场景分开打包进入对应场景时再动态加载对应包。配合 CDN 预下载和本地缓存可以实现场景秒切。第三道坎是 WebAssembly 编译时间。首次加载小游戏时wasm 需要在设备上编译性能差的手机可能要等好几秒甚至十几秒。这个不能用技术手段完全消除但可以通过分包机制让首屏必要代码体积尽量小同时开启 wasm 的流式编译微信工具里可以配置 enable-webgl 相关参数能在一定程度上摊平编译阻塞。加载界面也要做好别让用户以为游戏卡死了。4. 个人主体发布全流程4.1 小程序账号注册与主体认证发布前必须在微信公众平台注册一个小游戏账号。注册时账号类型选择小游戏主体类型选择个人。这里有个关键提示个人主体的注册身份证信息务必和后续提交审核时保持一致姓名和身份证号错了会被打回重新认证整个流程会多花好几天。注册完成后会进入微信认证流程。个人主体认证相对简单不需要对公账户打款验证只需上传身份证正反面照片按指引做人脸识别或短信验证。这里我要吐槽一句微信认证每年需要续期费用视当前政策而定但个人主体认证费用比企业主体低。认证通过后你的账号主体就是个人的个人主体在功能权限上会有一定的限制比如无法开通支付、部分类目不可选但对免费小游戏来说完全够用。接下来要完善 AppID 和 AppSecret。在公众平台的后台开发管理-开发设置里可以拿到 AppID这个就是后续 Unity 插件上传代码时要用到的标识。AppSecret 属于敏感信息不要暴露在客户端代码里如果只是用微信开发者工具的自动上传功能工具会引导你完成登录授权不需要在工单里手动填 AppSecret。4.2 上传代码、提审与发布代码上传有两种方式。一种是在微信开发者工具里点击右上角的上传按钮填写版本号和备注后上传另一种是从 Unity 插件的上传入口直接提交两者本质一样。上传成功后去公众平台的后台版本管理里能看到刚上传的版本点击提交审核即可。提审阶段有几个高频被拒原因提前避开。第一是首包超限也就是主包超过了 20MB 限制第二是内容含红包/抽奖/涉黄涉政等违规内容这个不多说任何擦边球都别碰第三是没有隐私政策个人主体做小游戏也需要在设置里补充隐私保护指引说明你的程序如何收集、存储、使用用户信息第四是类目不符个人主体可选类目里如果找不到小游戏这个类目就选工具-效率之类的相近类目然后在描述里说明这是一个游戏类应用审核员会按实际情况判断。审核时间一般 1-3 个工作日也有当天出结果的取决于你提交的时间段和当时的审核队列。审核通过后后台会出现发布按钮点击后游戏就正式对小游戏用户可见了。这里提醒一下发布不是终点你仍然可以在后台更新版本、发布新版本每次发新版都要重新提审。4.3 发布后的数据监控与迭代游戏上线后你第一时间要关注的是首日崩溃率和次留。在公众平台的数据分析里可以查看用户详细的行为数据包括打开次数、新用户数、留存率等。崩溃率高的话优先排查内存问题特别是低端安卓机很多 Unity 转小游戏的包在高端 iPhone 上稳如狗到了低端安卓上就闪退基本就是内存超限或者 GPU 兼容性问题。另一个重要的监控维度是加载耗时。小游戏包体大、wasm 编译时间长直接导致用户打开时白屏很久。你可以在游戏代码里打点统计 load 完成的时间点如果平均值超过 5 秒就该认真做分包和压缩优化了。用户对首屏加载的耐心非常有限白屏超过 3 秒就会流失相当一部分人。数据反馈驱动迭代的方向一般是看用户卡在哪一关流失看哪个关卡点击率低看广告展示量是否过高影响体验。Unity 项目本身的数据统计可以通过 JSBridge 上报到微信后台也可以用第三方统计平台但注意隐私合规收集用户数据前要弹出隐私说明。5. 常见问题排查实录5.1 转换失败类问题转换失败这个问题出现过很多次大多数是配置层面的原因。比较典型的有Unity 版本没有装 IL2CPP 模块、插件版本和 Unity 版本不兼容、导出目录路径里有中文字符或空格导致插件脚本解析失败。这类问题解法很简单先仔细看报错日志里的关键行再回 Unity 里逐项排查。还有一个隐蔽原因是杀毒软件或 Windows Defender 拦截了插件写文件导致转换一半就失败关闭实时防护再转一次往往就好了。另一个高频问题是导出后 JS 报错 Uncaught TypeError: Cannot read property unityInstance of undefined。这个一般是因为 WebGL 的 index.html 模板被改动过或者插件没有正确识别 Unity 的加载器。用默认模板重新导出一次不要手工改 index.html问题就没必要存在。5.2 运行异常类问题运行期最磨人的是白屏。引起白屏的原因太多了Unity 侧加载主场景失败、wasm 初始化超时、资源路径错误、微信基础库版本太旧无法支持 WebGL 等等。排查思路是先打开微信开发者工具的真机调试模式看 console 日志有没有报错如果真机报错但模拟器正常优先怀疑内存占用过高导致 App 被杀。还有一个非常容易误判的问题是声音播放失败。Unity 的 AudioSource 在小游戏环境里首次播放需要在用户点击或触碰后触发因为微信对自动播放有严格限制防止页面一打开就放声音。处理方法在游戏启动后引导用户点击一次屏幕在点击回调里创建一个已加载的 AudioSource 并播放一个极短的无声音频把音频上下文激活后续所有声音才正常。很多人声音时有时无就是没处理这个自动播放策略。5.3 审核被拒类问题被拒之后不用慌后台会给出具体的拒绝理由多数是缺少隐私政策类目不合含敏感内容。其中隐私政策几乎是个人主体首次提交最容易踩的坑因为很多人觉得个人开发的小游戏不需要隐私合规但平台要求的就是任何收集用户信息的行为包括微信登录时获取头像昵称都必须声明。在公众平台设置里补充隐私保护指引说明你收集哪些信息、如何存储、如何使用通过后再提审就会顺畅很多。还有一种被拒理由是内容低俗或涉及现金奖励诱导。小游戏里别搞什么签到送现金、分享得红包这种擦边玩法个人主体在合规审核上更容易被从严。老老实实做游戏内容、广告变现审核通过率会有保障。5.4 实际操作中的两三句体己话我见过太多人死在我项目跑通了但转换后手机上一看就崩。这里两句话第一句是一定要在早期做一次完整链路的真机验证别等项目做完了才去搞小游戏适配第二句是合理的取舍比堆功能重要Unity 项目里很多功能在小游戏端并不必要砍掉它们不只是减包体更是减崩溃率。根据我个人经验从 Unity 项目到微信小游戏上线如果轻车熟路一个小项目一周内可以跑通全流程如果第一次做给自己留出三周时间论调会比较合理。过程中最值得投入精力的不是打包而是真机调试和内存优化这两项做踏实了后面的路基本顺了。希望这篇流程梳理能让你少踩几个我踩过的坑早点把游戏搬上微信。
