经历了半年的独立开发我手里那个用Unity做的小游戏终于以“个人主体”身份成功上线微信小游戏平台了。整个过程没有注册公司没有折腾企业认证甚至很多环节都不需要动用版号这块硬骨头。我今天把从零到上线的完整流程整理出来尤其是那些我在官方文档里翻不到、只能在踩坑中体会的细节希望能帮准备走这条路的朋友少走几个月的弯路。先说一个很多Unity开发者容易搞混的点微信小游戏的“个人主体”通道跟App游戏上线完全是两码事。个人主体走的是微信公众平台的“小游戏”类目审核按平台当前规则很多休闲、益智类目不需要提供网络游戏出版物号这就是“免版号”的由来。但它不是免费通行证微信自己的内容审核、类目材料、软著要求依然一样不少。这篇博文我会把账号注册、工程改造、打包构建、提审发布全流程拆开讲并附上我在实际项目中踩过的坑和验证过的解法。1. 先搞清楚个人主体到底能发什么、需要准备什么1.1 免版号的真实范围先说个结论免版号不等于免审核更不等于什么游戏都能发。我理解很多独立开发者听到“免版号”三个字会兴奋但微信平台的规则其实卡得很细。按当前主流情况个人主体可选的小游戏类目主要是休闲、益智、工具、模拟等偏轻度方向这些类目在提交时不需要提供网络游戏出版物号流程上确实少了一大截。但有个关键前提你不能在小游戏里做“虚拟支付”相关的商业模式。微信对个人主体小游戏的支付能力限制很死简单的说个人主体不能开通虚拟支付所以你无法直接在游戏里卖道具、卖皮肤。我自己的项目就是靠激励视频广告变现的这反而是个人开发者最务实的路径。还有一点需要区分清楚你注册的小程序账号类型必须是“小游戏”而不是普通的“小程序”。两者虽然同一个后台但资质要求、代码包结构、审核标准完全不同。刚开始没注意的话很容易在账号类型上栽跟头后面想改主体或类型非常麻烦。1.2 个人主体和企业主体的选择很多教程会直接推荐你注册公司、走企业主体理由是支付能力、接口权限更全面。但从我的实际操作体验来看如果你是个人开发者、预算有限、游戏体量也不大个人主体完全够用而且省去了刻章、开户、年审这些杂事。个人主体的最大限制集中在两点一是不能开通虚拟支付二是一些能力接口比如某些社交关系链数据、部分开放能力拿不到。如果你的游戏变现模型是“纯广告”那这两个限制其实基本无感。但如果你规划里明确要做内购那趁早注册个体户或公司别在个人主体上死磕。另外提一嘴个人主体在审核速度上并不一定比企业主体慢。我自己从提审到过审最快的一次只用了不到两天但前提是资质材料齐全、隐私协议写得规范、游戏内容没有出格的地方。1.3 软著到底要不要办这是最近微信社群里问得最多的问题之一。按我掌握的情况微信小游戏个人主体提审时软著计算机软件著作权登记证书依然是很多类目的硬性要求尤其是棋牌类、消除类、合成类等明显具有“游戏属性”的类目基本都会要求上传软著。但这里有个实践技巧软著的登记人和你的微信小游戏账号主体不需要是同一人。我自己的软著用的是个人名义申请的账号主体也是我个人自然没问题。如果你的游戏是两个人合作做的软著上可以写两人共有或者提前约定好归属免得后面扯皮。软著申请渠道有两类一是自己在中国版权保护中心官网申请费用低但周期较长通常要30到60个工作日二是找代办费用一般在300到600元之间加急的话3到7个工作日能下证。我当时因为赶档期选了代办加急省下来的时间比费用值钱多了。软著证书建议提前办不然后面提审时临时去弄整个项目节奏都会被打乱。2. 环境准备引擎、工具、账号一个都不能少2.1 引擎选型Unity官方导出还是团结引擎先直接回答一个高频问题Unity自带的WebGL导出流程能不能直接用于微信小游戏答案是可以但不推荐直接用原生流程硬刚因为这中间隔着一层“浏览器环境”和“微信小游戏环境”的差异。微信小游戏没有DOM、没有完整Web APIUnity的WebGL产物必须经过适配层转换才能在微信里运行。目前实操中比较成熟的方案有两套第一套是Unity官方提供的“微信小游戏适配插件”。这个插件本质上是一个适配层加打包工具你在Unity里导出WebGL再用插件处理成微信小游戏格式。优点是路径明确、官方维护缺点是兼容性细节多遇到问题要找资料比较费劲。第二套是用团结引擎。团结引擎是Unity中国团队推出的国内版本内置了一键导出微信小游戏的能力把很多兼容性和性能问题提前处理掉了。我自己的项目是用团结引擎完成的当时看中的就是它对国内小游戏环境的深度适配光内存管理和文件流这两块就少了我很多事。如果你已经用Unity写好了完整项目迁移到团结引擎的代价很低基本都是打开工程换个版本的事。说句实在话做微信小游戏我给朋友的建议首选都是团结引擎省心是排第一位的。2.2 必装工具清单开始动手之前把下面这些工具准备齐Unity编辑器如果你用团结引擎去官网下团结引擎稳定版就行不用额外装国际版Unity。群里有朋友问过能不能同时装两个实测可以但要注意工程版本兼容性别用高版本编辑器直接改旧工程然后保存容易把Asset序列化搞乱。微信开发者工具这是提审和调试的必经工具下载稳定版就行。它内置代码编辑器、调试器、性能面板、真机预览功能用途非常广。Node.js部分适配脚本和构建工具依赖npm包装LTS版本就行。图片压缩工具或脚本小游戏包体大小有硬限制后面会细说提前准备好压缩工具能省很多事。这一套下来基本就齐了。别一上来就装一堆插件工具越多排查问题时干扰项越多先把最小闭环跑通再逐步加东西。2.3 微信公众平台注册与AppID注册环节看着简单其实有几个关键选项很容易选错。打开微信公众平台官网选择“小程序”注册注意这里用的是小程序入口不是“公众号”。注册流程中会要求选择主体类型这里必须选“个人”然后填写身份证信息、手机号、邮箱。完成注册后进入小程序后台不要急着写代码先去“设置-基本设置”页面确认你的账号类型是不是“小游戏”。如果注册时选了普通小程序进入后台后依然是“小程序”类型需要在后台申请变成小游戏但能不能转成功取决于官方审核所以最好注册时就想清楚。AppID在“开发管理-开发设置”里能看到是一个以wx开头的字符串。这个ID以后打包和预览都要用建议存到一个记事本里后面流程中会反复出现。我还习惯把AppSecret也复制一份保存好不过要注意它是敏感信息不能打进代码包更不能提交到Git仓库。3. Unity工程改造让小游戏环境认得你的游戏3.1 项目基础设置Unity工程要适配微信小游戏环境有几个基础设置需要提前调整。首先是分辨率适配问题微信小游戏是在手机屏幕里跑的不同机型屏幕比例差异非常大。我的做法是提前设定好“设计分辨率”然后通过代码适配实际屏幕的宽高比而不是让Unity强行拉伸。具体操作上在Project Settings里把默认分辨率和全屏模式设置好同时在游戏逻辑中处理SafeArea安全区域问题。尤其是iPhone的刘海屏和底部Home条不注意的话UI会被遮挡观感非常差。我用了一套简单的锚点方案再加上iPad分屏场景的适配基本能覆盖市面上主流机型。其次是输入系统的适配微信小游戏的环境比较特殊。Unity的Input类在小游戏环境下能正常工作但某些依赖鼠标、键盘的逻辑要改成触摸。我项目里有用到多点触控实测在微信开发者工具里模拟和真机上行为基本一致但精度和响应速度有差异所以关键操作最好在真机上多测几遍。3.2 适配层为什么必须装微信适配插件理解适配层非常重要否则后面遇到奇奇怪怪的错误时会一头雾水。Unity导出的本质是WebGL运行时它默认假设自己跑在浏览器里需要window、document这些对象。但微信小游戏环境没有这些它只有自己的全局对象所以两者之间必须有一层翻译官把Unity对浏览器的调用转换成微信小游戏的调用。这个翻译官就是适配层。以团结引擎为例它已经把适配层集成进了导出流程知道你选择的是微信小游戏平台就会自动生成和嵌入对应代码。如果用Unity官方插件你需要手动把适配层资源放进工程过程也不算复杂但对版本一致性要求较高。很多新人第一次打包后在微信开发者工具里报一堆错全是undefined、is not defined之类不用怀疑大概率就是适配层没接好。解决思路是先确认你的Unity版本和适配插件版本兼容再检查导出目录里有没有生成对应的适配文件别一上来就改代码那样越改越乱。3.3 分包与首包体积控制微信小游戏对代码包体积有严格限制我记得主包大小上限是4MB总包含所有分包也有上限。Unity游戏随便一个程序集加资源就几十MB了所以体积控制是必须做的一步。实际操作分两个方向一是代码裁剪Unity的“Managed Stripping Level”要适当调高能去掉不少用不到的托管代码二是资源外置把大的美术资源、音频、图集放到服务器上在游戏运行时动态下载微信小游戏的远程资源机制可以配合使用。我自己项目里的做法是启动场景、核心UI、首屏资源放在主包其他关卡、音效、剧情内容全部做成分包或者远程资源。首次进入游戏只加载主包保证在微信里秒开后续玩家进入具体关卡时再按需拉取资源配合Loading界面观感也顺。分包方案要注意加载时序问题不能在分包还没下载完成时就去加载里面的资源否则会报找不到资源。正确做法是用微信小游戏提供的分包加载接口去预下载再在Unity层面做资源加载的排队和判空。4. 打包构建全流程实操4.1 Unity导出微信小游戏格式我用团结引擎为例说说完整导出流程。首先在Build Settings里选择微信小游戏平台注意第一次使用时会提示你安装对应模块跟着提示完成后会多出一些微信相关的打包选项。关键一步是配置AppID和资源服务器地址。AppID在打包选项里直接填便于工具生成合法的project.config.json。资源地址填你的CDN根路径如果你计划把资源外置这一步必须配置正确否则真机运行时会一直卡在加载界面。配置完成后点击构建引擎会生成一个微信小游戏工程目录里面包含game.js、game.json这些标准文件以及Unity WebGL的产物。这里宣告一下看到一堆wasm、js、data文件不用慌它们就是Unity运行时的搬运结果。整个构建过程大概要几分钟到十几分钟取决于机器配置和工程复杂度。构建期间不要频繁操作Unity编辑器否则容易卡死我遇到过构建中途编辑器崩溃的情况之后学会了构建前先保存场景和工程。4.2 微信开发者工具导入与首测构建完成后打开微信开发者工具选择“导入项目”目录选你刚才生成的微信小游戏工程根目录AppID填你注册时拿到的那个。导入成功后开发者工具会自动编译并打开模拟器界面。第一次看到模拟器里出现自己游戏画面的那一刻成就感确实很足。但如果画面黑屏或者一直转圈先别慌按流程排查打开开发者工具的“调试器”Console面板看有没有明确的红色报错。大多数情况下问题出在资源路径、网络请求失败、或者适配层版本不匹配。开发者工具还提供了一套性能分析工具可以查看CPU占用、内存占用、帧率曲线。我在这个阶段做过一次完整的性能摸底把那些在编辑器里跑得很流畅、到小游戏环境却掉帧的地方挨个找出来趁早处理比上线后被动修复强得多。4.3 真机预览与线上环境联调开发者工具模拟器毕竟只是模拟器真机表现才是最终标准。微信开发者工具支持一键“预览”操作后会生成一个二维码用微信扫码就能在真机上运行你的小游戏。真机调试阶段重点看三样东西一是首屏加载时间二是帧率稳定性三是内存水位。首屏加载时间如果超过5秒玩家流失率会明显上升所以分包策略和资源外置的配置要在这个阶段反复调整帧率方面Unity Profiler在真机联调也能连上我用它来观察具体是哪段逻辑在吃性能。内存方面更直观微信开发者工具里能查看小游戏当前占用如果频繁超限导致闪退就要考虑降低纹理压缩质量、减少常驻对象数量。我一度把场景里所有非必需的对象都改成延迟实例化内存降了三分之一效果立竿见影。5. 提审与发布从项目进入正式线上5.1 提审材料清单与打包准备在提审之前你需要把下面这些材料准备好个人身份证正反面、软著证书如果类目要求、游戏截图至少4张、游戏介绍文案、隐私保护指引。隐私保护指引很容易被忽略但如果缺失或不规范审核会直接打回。这里有一个容易踩的细节微信小游戏提审时的版本号必须符合要求版本格式一般是x.x.x而且每次提审版本号要比上一版高。我第一次提审时忘了改版本号结果被提示“版本号重复”白白耽误了一个审核周期。还有一个容易被忽略的准备工作是关闭调试模式。正式提交时开发者工具右上角的调试开关必须关掉否则审核人员打开游戏会看到调试浮层这种低级错误会导致直接驳回。我自己被这个坑过一次后来总结了一条完整的上线前自检清单每一栏都打勾才提交。5.2 类目选择和信息填写技巧类目选择直接影响审核速度和通过率。个人主体下可选类目不算多我建议根据游戏实际内容选择最匹配的类目不要为了“好过”去选一个跟实际内容不符的类目。审核人员不傻他们会先体验游戏再对照类目对不上反而麻烦。游戏名称也有门道。微信小游戏有名称唯一性要求重名一百个肯定不行太生僻又不利于传播。我当时的策略是起一个包含核心玩法关键词的名称再在名称后面加上“小游戏”后缀既满足唯一性要求也降低了审核人员的理解成本。在“功能介绍”和“游戏简介”里我建议写清楚玩法和亮点别写空话套话。审核人员每天过大量游戏简介写得清楚也能间接提升通过率。截图要注意尺寸规范不能用黑边、不能含有违规标语最好放真实游戏画面修图过度的截图会被怀疑货不对板。5.3 审核不通过的常见原因与处理审核不通过是大概率事件关键是快速定位原因并整改。我把常见的驳回原因分成了几类第一类是内容问题包括名称与内容不符、有诱导分享、有敏感词等这类需要修改文案或删减相关功能。第二类是三俗和版权问题比如用了未经授权的角色形象、素材即使是无意的一旦被驳回就只能替换资源。第三类是合规材料问题软件著作权证书照片模糊、信息不一致等情况重新上传即可。每次驳回都会附带审核人员的具体意见认真阅读意见比到处问人更有效。我的经验是把每次驳回原因和对应修改记录下来形成自己的“审核问题库”后续版本迭代时就能主动避开同样的问题。6. 个人开发者避坑实录那些文档里不写的经验6.1 首屏加载慢的问题首屏加载慢是Unity小游戏最典型的性能坑。我在第一个版本里就栽过跟头当时首包体积做到了接近6MB结果真机加载慢得像看PPT。后来做了两个关键改造一是把启动场景和首屏必要资源压缩到最小二是在微信后台配置了资源预下载配合分包加载终于把首屏时间控制在3秒左右。另外尽量用市面上正规的CDN服务不要贪便宜用个人服务器加载速度差距非常明显。6.2 Unity的内存管理在微信里“不够用”Unity的内存管理在编辑器里跑得很欢但小游戏环境的内存上限远低于PC。最有效的办法就是“按需加载用完即释放”。我项目里有个很大的道具系统之前所有道具数据常驻内存后来改成打开图鉴时才动态实例化内存占用瞬间降了40%。善用Unity的Profiler去查找内存泄漏点很多看似没问题的地方一查都是漏洞。6.3 广告接入与收益配置变现是个人开发者必须面对的问题。我接入的是微信官方的激励视频广告流程比较简单申请广告位ID、在代码里实例化广告组件、在游戏逻辑中接入展示时机。踩过的坑主要有三个一是广告组件初始化要避开首帧否则会卡顿二是广告加载失败要设置重试机制不能直接影响游戏流程三是不要把激励视频广告做得太生硬玩家看广告应该换到实际价值复活机会、双倍奖励、额外道具等。就我目前的数据来看广告场景年轻用户完看率高收入虽然谈不上躺赚但每个月服务器和工具成本肯定能覆盖掉。6.4 版本更新与数据观察游戏上架不是终点线上运营才是持续的挑战。每次版本更新都要重新提审审核通过后过几个小时才会在线上生效。我习惯在版本发布之前先通过开发者工具“体验版”让内部测试一波环境正常了再提正式版本。微信后台给的数据面板能看访问趋势、留存、分享转化、广告收益曲线多花点时间研究这些数据比闷头加功能要有价值得多。最后再分享一个我踩了很多次才记住的细节Unity工程和小游戏工程最好分开版本管理Unity工程用于开发维护而小游戏发布目录作为独立的构建产物去管理不要混在一个仓库里否则每次构建都会产生大量diff排查问题时非常痛苦。个人开发者精力有限把流程理顺了后面才能把更多时间留给真正的游戏设计。
核心原理与Spring实战解析)
