Unity团结引擎开发微信小游戏踩坑日记

原创 已于 2025-08-29 18:17:24 修改 · 665 阅读 · 6 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#unity #微信小程序 #团结引擎

于 2025-06-04 20:02:04 首次发布

Unity团结引擎开发开发踩坑日记

第一坑

团结引擎转换微信小游戏报错：Exception: Invalid WebGL template path:XXX

https://docs.unity.cn/cn/tuanjiemanual/Manual/WechatSDK.html

微信小游戏转换SDK 下载，因为我电脑上没有部署git，所以是直接下载导入到项目中，结果转换的时候就会报错。
原因：WXSDK的WXConvertCore.cs源码的地址是“Packages/com.qq.weixin.minigame/WebGLTemplates/WXTemplate2022TJ”。但是导入的WebGLTemplates文件不在Packages文件下。![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/3649234a5a9946888166b344ccbd8c4c.png#pic_center
修改：将上述路径改为目标文件所在路径 “Assets/WebGLTemplates/WXTemplate2022TJ”后再次转换就成功了。
在这里插入图片描述

第二坑

The file can not be loaded because it was created for another build ta

最低0.47元/天 解锁文章
团结引擎 | 微信小程序开发
原在路上的博客。
01-12 1740
不会？不懂？看教程咯。以下是官方教程以及示例教程。
微信小游戏开发流程
qq_34256136的博客
12-17 1019
最新的版本会有一个latest的标签，我们项目中使用路径时要如图所示选择"根据Badge"来复制路径，这样项目中的存储桶地址就不用改了，这个地址永远指向最新的版本库。点击左上角的"+"按钮，选择使用git url，然后将方法一种的地址填入，点击右边的"Add"按钮就可以进行安装了，过一会WXSDK就安装好了。然后勾选"微信小游戏"模块，安装好之后新建一个工程，创建好工程之后通过如图方法一的方式安装"微信SDK"，接着安装"微信开发者工具"。打开网站后，选择左边的"安装与使用"项，下载最新版本的团结引擎，
团结引擎开发遇到的坑（1）
最新发布
maybeyaluokenai的博客
08-18 192
1.如果继承monobehaviour的脚本序列化到inspector面板的参数类型发生变化，变化的目标类型脚本为自己写的类型（为ugui自带的不会出现异常）时，并且之前挂载的游戏物体并没有挂载对应的目标类型脚本。此时unity在重新编译该脚本时出现TypeMismatch 异常，这个异常在Android平台会导致一旦尝试加载这种有TypeMismatch的资源会导致闪退。，将回调的参数类型改为值类型即可，使用回调跨程序集传输时尽量不要传复杂参数（带？2.Android平台，在程序集1尝试利用回调传。
团结引擎1.1.0-1.1.2打包微信小游戏报错
Roselele的博客
05-08 1973
请删除Asset目录下的微信SDK目录，然后从Package Manager安装微信SDK package。可以从Package Manager安装微信SDK（需要本地机器安装git不要用官网上的Unity package插件导入方式（
The file can not be loaded because it was created for another build target that is not compatible wi
brook0344的专栏
03-29 3789
03-23 14:35:05.274: E/Unity(5354): The file can not be loaded because it was created for another build target that is not compatible with this platform.03-23 14:35:05.274: E/Unity(5354): Please make s...
Unity开发微信小游戏踩坑总结
lwb314的专栏
12-30 756
不记录真记不住，这个帖子以后不定时更新。
精选资源
Unity3d C# 开发微信小游戏分享图片、朋友圈等功能实现源码
06-17
开发一个游戏后，最佳的宣传途径就是...部分功能可能只支持Android手机，具体参照官网由于插件一直在更新中，接口和实现可能随时间变化会差异，本资源就是Unity3d C# 开发微信小游戏分享图片、朋友圈等功能实现源码。
Unity 全套流程打包微信小游戏（新手教程）
qq_37524903的博客
04-10 3949
链接:官方教程链接:常见问题。
unity转微信小游戏排行榜Demo-202501
01-23
Unity是一款跨平台的游戏开发引擎，能够为开发者提供便捷的游戏开发环境和丰富的功能。但是，由于平台的差异性，直接在微信小游戏平台运行Unity开发的游戏并不是一件简单的事情。这需要通过特定的转换工具和方法，将...
团结转换微信小游戏报错：Exception: Invalid WebGL template path:XXX
weixin_56809718的博客
11-04 1282
原因：WXSDK的WXConvertCore.cs源码的地址是“Packages/com.qq.weixin.minigame/WebGLTemplates/WXTemplate2022TJ”。然而WebGLTemplates文件不在Packages文件下。修改：将上述路径改为目标文件所在路径 “Assets/WebGLTemplates/WXTemplate2022TJ”
Unity之Assetbundle打包出错：Editor only objects cannot be included in AssetBundles；or can‘t be loaded
大话程序员
02-19 3432
又双叒是Assetbundle的问题 主要问题还是 Lightmap.asset的问题（unity2017的lightmap文件也有问题？？） 出现这个提示原因： gz_xxx.scene 有标记assetbundle 而 gz_xx 目录（放lightmap的目录)没标记，则不会打包进 assetbundle 所以囧有 lightmap 这个 .asset 文件仅在 editor 生效的提示 解决方法： 暂时不知道 ...
团结引擎（Unity中国、Unity）打包微信小游戏流程
weixin_44151759的博客
01-04 4211
团结引擎（Unity中国、Unity）打包微信小游戏流程。
WEBGL Template 默认安装位置及相关修改
SusieMiao的博客
09-03 1991
1 WEBGL Template 默认位置：D:\Program Files\Unity\Editor\Data\PlaybackEngines\WebGLSupport\BuildTools\WebGLTemplates 2 我的Unity安装到了D盘，可以右击桌面的Unity编辑器图标，打开文件所在位置，再依次点击Data--PlaybackEngines--....,后面的路径同上。 3...
Unity/团结引擎游戏快速适配微信小游戏方案解析
gitblog_00271的博客
06-11 593
Unity/团结引擎游戏快速适配微信小游戏方案解析 方案概述 Unity/团结引擎游戏快速适配微信小游戏方案是一套基于WebGL和WebAssembly技术的完整解决方案，旨在帮助开发者高效地将Unity或团结引擎开发的游戏移植到微信小游戏平台。该方案最大特点是无需使用JavaScript重构游戏逻辑，保持原有引擎工具链和技术栈，大幅降低移植成本。 核心优势 1. 技术架构创新 该方案采用WebG...
Unity - 微信小游戏
青衫磊落长歌行的博客
05-03 1893
Unity to wechat minigame
关于Unity发布的WebGL项目出现问题的解决方法和本地网站部署
热门推荐
CoffeMilk的博客
08-21 1万+
一、关于将Unity的项目打包为WebGL出现Exception: E:\Unity\Editor\Data\il2cpp/build/il2cpp.exe did not run properly! UnityEditorInternal.Runner.RunManagedProgram (System.String exe, System.String args, System.String ...
Unite Shanghai 2024 团结引擎专场 | 团结引擎小游戏开发指南
unityofficial的博客
10-08 2374
首先，我们分享两个实际案例的测试数据，看看团结针对小游戏的优化效果。接下来，针对小游戏开发过程中的各个阶段，逐个分析。首先会看小游戏平台适配有哪些需要注意的地方：新开发的小游戏或者原生app转的小游戏，都会遇到这个问题。接下来是启动加载的优化，小游戏即点即玩，玩家期望游戏拉起的越快越好，启动越快玩家的首屏留存率越高。然后是游戏内容的边下边玩。游戏内容越来越丰富，资产体积越来越大。这些资产不可能都在游戏启动前下载完毕，需要伴随游戏的进程边下边玩、按需下载。这里会介绍相关的工具，以及注意的事项。
【坑爹】布署CDN时，坑爹的IDC缓存（游戏补丁包被坑一事小记）
奋斗的老刘
07-31 1400
引子： 游戏项目用Unity开发，补丁放置于CDN上面，由于区分Android和iOS平台，所以添加目录区分，例如：5.0.0.0 => 5.0.0.1  [appstore目录]      |_5.0_5.1.zip [android目录]      |_5.0_5.1.zip 现象： 不断有玩家反馈，在更新完之后，无法进入游戏 BugReport， 收到玩家的U
团结引擎 | 发布微信小游戏的那些坑
该用户还没想到好的昵称的博客
01-09 2767
发布webGL遇到的那些坑
团结引擎开发微信小游戏登陆功能
08-16
在团结引擎中开发微信小游戏的登录功能，主要涉及微信小游戏平台提供的用户认证机制，以及团结引擎对微信小游戏平台的支持与集成能力。以下是一个基于团结引擎和微信小游戏平台特性的开发指南[^1]。 ### 一、微信小游戏登录机制概述 微信小游戏平台提供了基于微信用户体系的身份验证功能，开发者可以通过微信提供的接口获取用户的唯一标识（如 `openid` 和 `unionid`），并结合自定义的服务器逻辑实现用户登录、数据同步等功能。微信登录流程通常包括以下几个步骤： 1. 调用微信小游戏的 `wx.login` 接口获取临时登录凭证 `code`。 2. 将 `code` 发送到开发者服务器，由服务器向微信接口服务发送请求，换取用户的唯一标识 `openid` 和会话密钥 `session_key`。 3. 开发者服务器生成自定义的登录令牌（token），返回给小游戏客户端。 4. 客户端后续请求使用该 token 进行身份验证[^2]。 ### 二、团结引擎对微信小游戏的支持 团结引擎是 Unity 中国基于 Unity 2022 LTS 定制的实时 3D 引擎，专为中国市场优化，支持微信小游戏平台的发布[^3]。开发者可以通过团结引擎的构建流程将游戏打包为微信小游戏，并利用 Unity 的 C# 脚本系统与微信原生 JS 接口进行交互。 #### 1. 微信小游戏构建配置 在团结引擎中构建微信小游戏时，需确保以下设置： - 使用 Unity/团结引擎的 WebGL 构建目标。 - 安装适用于微信小游戏的 SDK 插件，通常可通过 Package Manager 添加特定的微信小游戏支持包，例如通过 Git URL 安装插件[^4]。 #### 2. 登录功能集成 为了在团结引擎中实现微信小游戏的登录功能，开发者需要通过 Unity 的 `UnitySendMessage` 方法调用微信小游戏的 JavaScript 接口。具体步骤如下： - 在 Unity 中创建一个用于接收微信登录信息的 GameObject，并为其绑定脚本。 - 在脚本中定义接收微信登录信息的方法，例如 `OnLoginSuccess(string data)`。 - 在微信小游戏的 HTML 容器中调用 Unity 的 `UnityInstance.SendMessage` 方法，传递登录信息（如 `openid`）。 示例 JavaScript 代码片段： ```javascript wx.login({ success: function (res) { if (res.code) { // 获取到 code 后发送给服务器并获取 openid // 假设服务器返回的 openid 为 "user_openid" unityInstance.SendMessage("LoginManager", "OnLoginSuccess", "user_openid"); } } }); ``` 在 Unity 脚本中接收消息： ```csharp public class LoginManager : MonoBehaviour { public void OnLoginSuccess(string openid) { Debug.Log("Login Success with OpenID: " + openid); // 在此处处理登录成功后的逻辑，例如加载用户数据 } } ``` ### 三、性能优化建议 为了确保登录功能在微信小游戏平台运行流畅，建议参考以下优化措施： - **资源加载优化**：避免在首场景加载过多资源，使用 `Addressables` 或 `AssetBundle` 实现按需加载。 - **网络请求优化**：控制并发请求数量，建议不超过 20 个。 - **代码分包**：使用代码分包工具，减少首包体积，提升启动速度。 - **包体大小控制**：单个资源包建议不超过 2MB[^5]。 ### 四、安全注意事项 - **敏感信息处理**：不要在客户端存储敏感信息如 `session_key`，应由服务器处理。 - **接口验证**：确保所有来自客户端的请求都经过服务器验证，防止伪造登录。
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值