Unity游戏发布微信小游戏：从构建到提审

一、工作内容
1. 微信小游戏接口构造
  Unity C#代码不能直接调用微信JS原生接口。微信小游戏存在主域、开放数据域双域隔离，好友数据只能在开放域读取，主域只能发送消息通知子域完成分数存储、榜单拉取。
实现：
  添加WeChatHelper.cs静态工具类，统一封装微信小游戏平台能力：游戏内分享、玩家最高分上报、排行榜弹窗显示/关闭。
  基于微信WASM SDK，利用PostMessage完成主域与开放数据域的消息通信；使用预编译指令#if UNITY_WEBGL && !UNITY_EDITOR区分编辑器环境与微信打包环境，真机环境下调用微信原生API；增加try-catch捕获异常，防止SDK未就绪时游戏崩溃。

2. 修复GameScene黑屏问题
  URP可编程渲染管线在微信WebGL环境存在着色器剥离问题，项目通过代码动态生成的精灵着色器，会被Unity打包裁剪移除，导致场景精灵黑屏渲染异常。
实现：
  优化URP渲染配置，更换URP2D渲染器并适配WebGL2.0、Gamma色彩环境，预载入精灵着色器防止打包剥离，修复场景黑屏问题。

3. 实现微信排行榜（开放数据域）
  微信出于用户隐私保护，限制游戏直接读取好友信息。好友排行榜数据只能在独立的开放数据域访问；开放域渲染完成后输出纹理给主域，主域把纹理贴到UI上展示。
实现：
  搭建微信小游戏双域架构，接入官方开放数据域模板。
  主域通过消息向子域下发指令：上报最高分、显示/关闭排行榜；子域负责调用微信云存储接口存取分数、绘制排行榜UI；主域通过RawImage接收子域渲染纹理，展示排行榜。

4. 解决编译器wasm加载失败问题
  微信小游戏个人开发者账号权限有限，不支持Layout插件；
  game.json内保留该插件配置会导致小程序启动时读取插件失败，wasm模块加载报错。
实现：
  定位打包后启动报错read plugin file empty的根源，修改game.json配置文件，删除Layout插件配置，清理缓存后重新打包，解决wasm文件读取失败问题。

5. 完成上传提审
  微信小游戏上线需要满足平台合规校验，隐私授权、类目资质、代码安全全部审核通过，小游戏才能对外发布。
实现：
  整理微信小游戏后台审核材料，填写服务类目、隐私协议、版本更新说明，打包正式版本，完成提审前自检，提交微信平台审核。

二、遇到并解决的问题
1. 渲染管线配置问题

• 现象：
  模拟器一开始UI、精灵全都黑屏，游戏界面加载不出来。
• 原因：
  项目初始使用URP 3D Forward渲染器，在WebGL平台兼容性极差。将渲染器替换为URP2D、颜色空间改为Gamma、图形API固定为WebGL2.0，解决了UI渲染问题，UGUI可以正常显示。
  但场景精灵通过Sprite.Create动态创建，没有静态资源引用，打包时会被 Unity 着色器裁剪机制误删，导致Sprite方块、场景背景依旧黑屏。
• 解决：
  将URP的 3D Forward 渲染器替换为URP 2D Renderer（URP2D），同时修改颜色空间为Gamma、图形 API 固定为WebGL2.0，UGUI 界面正常渲染；
  在Always Included Shaders添加Sprites/Default，强制打包保留该着色器，Sprite背景、游戏方块正常显示。

2. wasm加载失败

• 现象：
  模拟器编译报错read plugin file empty，wasm模块加载失败，游戏无法启动。
• 原因：
  微信小游戏个人主体账号没有Layout插件的使用权限。而game.json配置文件中声明了Layout插件，小程序启动阶段会尝试读取该插件文件，但文件不存在，直接抛出插件为空的错误，阻断wasm游戏代码加载。
• 解决：
  删除game.json文件中plugins节点内Layout相关插件配置；
  清理缓存，重新打包。

三、学习总结
1. 微信小游戏SDK调用
  通过微信WASM SDK，在Unity C#代码中调用微信原生能力，实现游戏分享、开放数据域控制等功能。

// 微信分享
WX.ShareAppMessage(new ShareAppMessageOption{title = "WoodPuzzle",imageUrl = ""}); 

// 向开放数据域发送消息，拉取好友排行榜
WX.GetOpenDataContext().PostMessage("{\"type\":\"showFriendsRank\"}");
// 输出开放数据域渲染的画面
WX.ShowOpenData(rankTex, 0,0,Screen.width,Screen.height);

// 关闭开放数据域渲染
WX.HideOpenData();

2. 微信小游戏双域架构
  微信小游戏分为主域与开放数据域两个相互隔离的运行环境：
  主域运行Unity游戏业务逻辑；开放数据域拥有读取微信好友关系、好友云存储分数的权限。两者用PostMessage通信。
  主域Unity不能直接读写微信好友云存储，只能发消息给开放数据域，由子域调用微信云存储接口：

// 主域：发送消息通知开放域上报玩家最高分
WX.GetOpenDataContext().PostMessage("{\"type\":\"setUserRecord\",\"score\":" + bestScore + "}");

// 主域：发送消息通知开放域拉取并展示好友排行榜
WX.GetOpenDataContext().PostMessage("{\"type\":\"showFriendsRank\"}");

3. 好友排行榜

• 分数存储：
  主域通过PostMessage下发指令；
  开放域收到消息后，调用微信接口setUserCloudStorage，把玩家分数上传到微信云存储。
• 榜单拉取：
  主域下发展示指令；
  开放域调用getFriendCloudStorage读取好友分数，并在子域Canvas绘制排行榜UI；
  主域调用WX.ShowOpenData()，把开放域画面渲染到RawImage上展示给玩家。
• 画面输出：
  开放域绘制完成后，通过SDK输出纹理到Unity的Texture2D对象；
  主域调用WX.ShowOpenData()，把开放域画面渲染到RawImage上展示。

// 将开放数据域渲染画面输出到主域纹理
WX.ShowOpenData(_rankTex, 0, 0, Screen.width, Screen.height);
// 关闭开放域渲染输出
WX.HideOpenData();

四、下一步计划

1. 等审核通过发布上线
2. 完成ICP备案