▶_MiniApp Toolkit

minigame-tuanjie-transform-sdk

工具

微信官方 Unity/团结引擎小游戏适配 SDK，帮助开发者将 Unity 项目导出为微信小游戏。支持 Unity 2022 LTS 及团结引擎，提供运行时适配、性能优化和资源管理能力。

官网文档
微信小游戏Unity团结引擎游戏开发官方SDKWebGL

详细文档

minigame-tuanjie-transform-sdk#

平台概述#

minigame-tuanjie-transform-sdk 是微信官方开源的 Unity/团结引擎小游戏适配 SDK。它让 Unity 开发者能够将现有的 Unity 游戏项目直接导出为微信小游戏，无需重写代码。

核心价值：Unity 是全球最流行的游戏引擎之一，在中国游戏开发领域占据主导地位。微信小游戏作为国内最大的小游戏平台，月活用户超 10 亿。本 SDK 是连接 Unity 生态与微信小游戏平台的官方桥梁，大幅降低了游戏开发者入驻微信小游戏的门槛。

项目数据（2026-07-31 核实）：

  • GitHub：173⭐ / 45 forks / MIT License
  • 维护方：微信小程序团队（wechat-miniprogram 官方组织）
  • 最近活跃：2026-07-31（持续高频迭代）
  • Open Issues：38（活跃的社区反馈）
  • 官方文档：developers.weixin.qq.com/minigame/dev/guide
  • 支持引擎：Unity 2022 LTS 及以上 / 团结引擎（Tuanjie Engine）

设计规范#

架构设计#

SDK 采用 运行时适配层 + 构建时转换 双层架构：

  1. 构建时转换：Unity Editor 中通过 Build Pipeline 将场景、资源、脚本转换成微信小游戏兼容格式
  2. 运行时适配层：在 WebGL 基础上提供 WASM 加速、文件系统模拟、微信 API 桥接

支持的 Unity 特性#

特性支持状态说明
URP 渲染管线✅ 完整支持推荐使用，性能最优
Built-in 渲染管线✅ 支持兼容旧项目
物理（PhysX）✅ 支持WASM 后端
动画系统✅ 支持Animator / Animation
音频✅ 支持通过 WX Audio API 适配
UI 系统✅ 支持uGUI / UI Toolkit
WebGL 纹理压缩✅ 支持ASTC / ETC2
视频播放⚠️ 部分支持通过 WX Video 组件
多线程❌ 不支持WebGL 限制（可用 Worker 模拟）

性能优化#

  • ** WASM SIMD**：自动启用 WASM SIMD 指令加速数学运算
  • 资源按需加载：支持资源分包、远程资源加载
  • 纹理压缩：自动转换为微信小游戏兼容格式
  • 代码裁剪：IL2CPP + managed code stripping 减小包体

审核规范#

  • 需遵守《微信小游戏运营规范》
  • 游戏类目需与实际玩法一致
  • 不得包含诱导分享、强制广告等内容
  • 内购需接入微信支付
  • 实名认证和防沉迷系统为强制要求

开发指南#

快速上手#

code
# 方式1：Unity Package Manager 安装
# Unity Editor → Window → Package Manager → + → Add package from git URL
# 输入：https://github.com/wechat-miniprogram/minigame-tuanjie-transform-sdk.git

# 方式2：直接下载 .unitypackage
# 从 GitHub Releases 页面下载
code
// C# 示例：调用微信 API
using WeChatMiniGame;

// 显示分享菜单
WX.ShowShareMenu(true, false);

// 登录
WX.Login(code => {
    // 将 code 发送到服务器换取 openId
    Debug.Log("Login code: " + code);
});

// 播放激励视频广告
var rewardVideo = WX.CreateRewardedVideoAd("adunit-xxx");
rewardVideo.OnLoad(() => Debug.Log("Ad loaded"));
rewardVideo.OnClose(res => {
    if (res.isEnded) {
        // 发放奖励
    }
});
rewardVideo.Load();
rewardVideo.Show();

常见陷阱#

  1. 空项目导出报错：如果游戏代码中从未使用 WXSDK 的 Runtime 能力，团结引擎可能裁剪微信 Runtime 包。解决办法是在合理位置增加对 WXSDK 的使用（如初始化调用）
  2. 包体过大：Unity 默认包含完整引擎代码，需配置 managed code stripping level 为 High 或 Very High
  3. 纹理格式不兼容：WebGL 2.0 不支持某些纹理格式（如 DXT），需使用 ASTC 或 ETC2
  4. 音频播放限制：微信小游戏要求用户交互后才能播放音频，不能自动播放
  5. Shader 兼容性：部分自定义 Shader 可能在 WebGL 后端渲染异常，需测试验证

与 minigame-unity-webgl-transform 的关系#

本 SDK 是 minigame-unity-webgl-transform 项目的团结引擎适配版本，两者共享文档站点：

项目适用引擎仓库状态
minigame-unity-webgl-transformUnity 引擎文档站（GitHub 访问受限）
minigame-tuanjie-transform-sdk团结引擎（Tuanjie）开源活跃（本仓库）

生态资源#

官方资源#

资源说明
官方文档站完整的小游戏开发指南和 API 文档
微信小游戏文档微信小游戏开发文档
Skyline SkillsSkyline 渲染引擎 Agent Skills

相关工具#

  • Unity 引擎：2022 LTS 或更高版本
  • 团结引擎：Unity 中国版，原生支持微信小游戏导出
  • 微信开发者工具：用于调试和预览导出的小游戏项目
  • threejs-miniprogram：Three.js 的小程序适配（非 Unity 路线）

社区资源#

  • GitHub Issues：38 个开放问题（活跃的社区讨论）
  • 微信开放社区：官方技术支持渠道

版本更新#

当前状态（2026-07-31 核实）#

  • GitHub：173⭐ / 45 forks / MIT License
  • 维护方：wechat-miniprogram 官方组织
  • 最近推送：2026-07-31（当日活跃）
  • 创建日期：2023-11-28
  • 仓库大小：95MB（包含示例资源）

迭代节奏#

  • 持续高频迭代，每周有代码提交
  • 跟随 Unity / 团结引擎版本更新适配
  • 跟随微信小游戏平台新特性提供 SDK 支持

核实记录#

  • 2026-07-31：GitHub API 核实，173⭐ / 45 forks / MIT / 最后推送 2026-07-31，状态活跃。Open issues 38 个，说明社区参与度高。与 minigame-unity-webgl-transform 文档站配套使用。