微信小游戏示例
微信小游戏示例
5分钟轻松搞定小游戏资源托管
1. 基本概念
团结引擎微信小游戏
通过团结引擎，您现在可以轻松将您的游戏项目转换、发布为微信小游戏，接触更广阔的玩家群体。为了更好地支持微信小游戏开发（环境适配、性能优化），团结引擎新增了 WeixinMiniGame 平台，基于WebGL，同时为微信小游戏做了特殊的支持与优化。
微信小游戏
UOS CDN
又名 ADN Asset Delivery Network, 是 Unity 官方推出，蓝云运营的资源更新服务，可以帮助开发托管微信小游戏使用到的资源文件。 了解更多
2. 打包微信小游戏
示例程序介绍
项目为团结引擎小游戏工程《不服咱碰碰》，主要用于 Wechat Minigame 的示例。
后续操作步骤仅适用于本示例项目，如果使用其他示例项目，请参考 团结引擎微信小游戏手册 进行操作
示例项目下载
下载上述示例项目Zip包，解压缩，得到BoatAttack文件夹。
导入团结引擎项目
1. 安装团结引擎
进入 团结引擎官网 ，点击「下载团结引擎」至 Releses 页面选择「从团结 Hub 下载」，下载团结Hub后通过Hub安装团结引擎(示例项目使用的是团结引擎1.2.0版本)。
2. 开通 UOS CDN
前往 UOS官网，登录后创建新的应用，在「概览」页面找到 CDN 并点击「免费试用」开通CDN服务，在「Buckets」页面「创建BUCKET」。
3. 导入项目
点击团结 Hub->「Projects」栏右上角「Open」按钮，选中刚下载的示例项目，即BoatAttack文件夹。在团结 Hub的「Projects」栏下面显示该项目，点击打开BoatAttack项目，需要耐心等待几分钟。
4. 打包编译
点击导航栏「File」->「Build Setting」，在 Platform 选择 Wexin MiniGame ，点击「Switch Platform」，等待平台的切换。
点击导航栏「Windows」->「Auto Streaming」，选择「Cfg & Publish」标签， 填写在UOS官网新建项目的 App ID 和 App Service Secret。点击「refresh」刷新，成功后可以看到页面下方已经获取到上面创建到Bucket和默认Badge。
注：此处 AppId 和 AppServiceSecret，可在 UOS 网站上获取
选择「Texture Streaming」标签，依次点击「Generate AssetBundles」、「Generate Placeholders」。
点击导航栏「Utilities」->「Build WXAssetBundles」，自动生成 AssetBundles 到目录 AssetBundles\WeixinMiniGame\，同时会自动将 AssetBundles 文件拷贝到 CustomCloudAssets。
「Build WXAssetBundles」为示例项目自定义脚本。
功能为整理出 AutoStreaming Editor 工具无法自动搜索到的资源，使用 BuildPipeline.BuildAssetBundles 进行打包，并将打包后的 AssetBundles 文件拷贝到 CustomCloudAssets。(如果自己的项目中不存在此情况，可以忽略此步骤)
目前使用 AutoStreaming Editor 工具能够自动搜索出以下方式使用到的资源：
- Build Settings 中所有 active 的场景，以及场景引用到的资源
- 通过 Inspector 中 AssetBundle 标签设置和打包的 AB
- 项目的 Resources 文件夹
- Addressable 中引用到的资源
AutoStreaming Editor 工具使用可以参考 官方文档。
使用UPR测试，需修改项目 Assets/UPRTools/Resources/WebGLSettings.asset 文件，在右边 Inspector 面板将Build Url改为 UPR Desktop 运行机器 IP地址（如何获取设备IP）。
导出微信小游戏
获取微信小游戏AppID（如果已有，跳过此步骤）。下载 微信开发者工具 ，打开后获取一个小游戏的AppID（初次尝试可使用测试号）。
返回团结引擎，点击导航栏「微信小游戏」->「转换小游戏」，会弹出“微信小游戏转换工具面板”，填写游戏AppID（对应刚刚获取到的微信小游戏 AppID），填写小游戏项目名，选择导出路径等，勾选"Development Build" 和 "Auto connect Profiler"，勾选WebGL2.0(beta), 然后点「生成并转换」按钮。
打包完成后，会自动上传AutoStreaming文件和首包资源文件到UOS CDN, 上传CDN后需要2分钟左右，才能访问到所有资源。
小游戏配置
登录 微信公众平台 ，扫码并选择设定好的测试号登录，请设置好合法域名，以免Demo程序无法正常运行。
由于Demo项目使用了UOS CDN托管资源，请将相关域名(https://a.unity.cn; https://a.unity3dcloud.cn;)配置到域名白名单。
回到微信开发者工具，选择打开项目，选择minigame文件夹，即可打开微信小游戏。
*如果微信开发者工具右下角右下角的Console可能会有个无法连接到127.0.0.1:56001的报错，这个是由于导入了UPR Package导致的，这是正常的，请不用担心。
4. 常见问题
团结引擎打开项目时报错
团结引擎打开项目时报错"error CS0246: The type or namespace'ManagerDefaultPrefab' could not be found..."？
打开「Windows」->「Package Manager」，若是 Gameplay Ingredients 安装失败（即net.peeweek.gameplay-ingredients），点击「Update」重新安装，并重启团结引擎。
小游戏下载资源失败怎么办？
AutoStreaming文件有概率上传失败，请检查下CustomCloudAssets目录下没有xxx.webgl.data.unityweb.bin.txt文件。建议将导出路径/webgl目录下的xxx.webgl.data.unityweb.bin.txt文件拷贝到CustomCloudAssets目录下，并点击「Cfg & Publish」标签下的「Upload to UOS CDN」按钮进行手动上传。
缺少 WXSDK Package
在 Unity Editor 菜单栏中打开 「Window -> Package Manager」，点击左上角的 「+」，选择 「Add package from git URL」，输入 Package 的 git 地址如下，点击 「Add」 等待安装完成。
https://gitee.com/wechat-minigame/minigame-tuanjie-transform-sdk.git#main