Unity 转微信小游戏及打包记录

本文由 NRatel 历史笔记整理而来，如有错误欢迎指正。

一、相关文档

Unity WebGL 微信小游戏适配

Unity WebGL 微信小游戏适配 | 微信开放文档

微信小游戏Unity/团结引擎适配方案

微信小游戏Unity/团结引擎适配方案 | 微信小游戏Unity/团结快适配

Git仓库 minigame-unity-webgl-transform

GitHub - wechat-miniprogram/minigame-unity-webgl-transform: Wechat Mini Game Unity engine adapter documents.

 技术常见问题QA

技术常见问题QA | 微信小游戏Unity/团结快适配

交流区

小游戏交流专区 | 微信开放社区

客服小助手

问题反馈与联系我们 | 微信小游戏Unity/团结快适配

后台（微信公众平台）

微信公众平台

1、Package方式安装 WXSDK

微信SDK安装 | 微信小游戏Unity/团结快适配

2、根据步骤转换

转换工具导出微信小游戏 | 微信小游戏Unity/团结快适配

3、下载微信开发者工具

微信开发者工具下载地址与更新日志 | 微信开放文档

脚本导出：

WXEditorWin.DoExport();

可在导出前修改配置：

Assets/WX-WASM-SDK/Editor/MiniGameConfig.asset

导出结果路径为：{UnityProject}/minigame

用微信开发者工具打开

​

先申请一个测试号

申请测试号 | 微信开放文档

AppID(小程序ID) ,如：wx88c888b8e8888e8a

AppSecret(小程序密钥) ,如：edd8888b8a88f88e8888c8e8a888c8e8

编译报错：

VM79:2 wx88c888b8e8888e8a 插件未授权使用 添加插件(env: Windows,mg,1.06.2412040; lib: 3.5.1)

(anonymous) @ VM79:2

VM79:3 插件文档: https://mp.weixin.qq.com/wxopen/plugindevdoc?appid=wxe5a48f1ed5f544b7&token=&lang=zh_CN(env: Windows,mg,1.06.2412040; lib: 3.5.1)

​

GET https://game.weixin.qq.com/StreamingAssets/MyRes/NoVersionResManifest.txt 404

​

微信小游戏不支持从包内读取 StreamingAssets 下的资源（与抖音不同，抖音支持）

若只想将资源方在包内，需要将资源放至Resources，否则需使用CDN。

二、自动化打包

介绍 | 微信开放文档

miniprogram-ci - npm

安装（后面重装指定版本）

npm install -g miniprogram-ci

查看上传命令支持的参数

miniprogram-ci --help

2个报错：

​

​

Spawn node ENOENT

均是 node 和 miniprogram-ci 版本的问题：

更换 node 版本（22.12.0）和 miniprogram-ci（2.0.10） 版本后解决。

但是具体版本对应关系暂未知。

后续发现，若在BuildApp阶段，minigame工程未生成，直接执行了 upload命令，也会导致此报错。

安装nvm （https://github.com/nvm-sh/nvm）

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

使用 nvm 安装/卸载指定node版本

nvm install 22.12.0

nvm uninstall 22.12.0

查看可用node版本

nvm list

使用（切至）某个node版本

nvm use 22.12.0

安装指定版本 miniprogram-ci

npm install -g miniprogram-ci@2.0.10

npm uninstall -g miniprogram-ci

注意，Jenkins 上也需切到指定版本node，使用指定版本 miniprogram-ci。

​

Ip 未配置到后台中白名单去（注意是外网IP）。

三、性能问题

微信包严重卡顿 帧数到个位数

优化Unity WebGL的运行性能 | 微信小游戏Unity/团结快适配

改为 WEbGL 1 打包后正常，但颜色空间须为Gamma（注意同时调整光照）和 正常。

但一些必须 为Linear空间的游戏，可以使用  WebGL2 打包，注意要设定3处:

​

概述 | 微信开放文档

四、排行榜问题

1、微信好友排行榜只能渲到RawImage上（有个开放数据域的概念），世界榜只能用自己的服务器上传拉取数据来做

​

传包时报错，是因为在勾选使用好友关系链后，依赖了 开放数据域渲染库 插件

​

插件授权地址，或导出后在微信开发者工具中，报错中点击授权：

开放数据域渲染库 | 小程序插件 | 微信公众平台

注意，不需要的SDK功能不要勾选，否则也需要授权，比如“使用社交组件”

进入游戏报错，

​​

原因：对于资源放入Resource发布的游戏，这里应该设为 小游戏包内，而非CDN

​