团结引擎配置微信小游戏工程

作者:追风剑情 发布于:2024-10-30 21:23 分类:Unity3d

团结引擎社区
教程《小程序开发指南》
[团结引擎手册] 微信小游戏
微信小游戏Unity/团结引擎适配方案
网络适配
微信系统字体
UnityWebSocket
代码分包
[微信官方文档].小游戏.指南
[微信官方文档].小游戏.框架
[微信官方文档].小游戏.API
[微信官方文档].小游戏.API.Camera
[微信官方文档].小游戏.服务端
WebGL native plug-ins for Emscripten
小程序.WebGL画面录制器
小游戏.游戏画面录制器
[github] 官方游戏示例
微信开放社区.小游戏
微信小程序.XR-FRAME
[github].xr-frame-demo
ShareSystem

1、安装团结引擎

https://unity.cn/tuanjie/releases

11111111111111111111.png

2、安装git

下载微信SDK要用到。https://git-scm.com/downloads/win。官方下载很慢,建议从其它资源下载。

3、安装WXSDK

https://gitee.com/wechat-minigame/minigame-tuanjie-transform-sdk.git

点击【install WXSDK】时,会调用 git 进行下载。

2222222.png

4、适配纹理格式(ASTC)

开启ASTC压缩后,小游戏在移动端运行时可以节省大量内存和显存。

33333.png

5、配置 Graphics API

取消勾选 Auto Graphics API,仅保留 WebGL 1 或者 WebGL 2。可以减少shader变体数量,从而减小首包和启动时间。使用 WebGL 1 时, 若 Lightmap Encoding 为 High Quality,将其改为 Normal。

iOS平台上使用 WebGL 2.0 需要系统版本高于15.0,并且打开iOS高性能模式。否则可能出现进入游戏后白屏的情况。

444444.png

或者

77777.png

1111111.png

6、安装 InstantGame Package

55555.png

如果在 PackageManager 中无法搜索到,请在项目的 Packages/manifest.json 文件中直接添加以下 package: "com.unity.instantgame": "1.0.11"

7、配置AutoStreaming功能

InstantGame 窗口位于 Windows → Auto Streaming,该窗口包含了打包小游戏前的资源 Streaming 设置,以及上传云资源到 UOS CDN 的设置。

UOS CDN 服务 提供免费 100GB 试用流量, 超出后将按照 0.15元/GB 收费。

6666666.png

  • 切换到 Cfg & Publish 窗口,勾选 Use AutoStreaming,如果后续需要使用正常的打包流程,取消勾选该选项即可。
  • (可选)勾选 Use Font Streaming,开启字体资源的Streaming。
  • Cache Texture AB in Memory,将下载的 Autostreaming 原始纹理AB缓存在内存当中,以减少纹理模糊的时间, 会明显提升内存使用
  • Max Cocurrent Load, 设置 AutoStreaming 最大后台下载和加载任务数量,允许的值是0–20,值为0时,使用引擎默认值。

InstantGame 窗口中的其它配置,请参考 团结引擎手册-微信小游戏-快速上手

  为了使用微信下载缓存,避免AB文件重复下载的同时,依旧支持游戏版本变动,即同一AB文件内资源随版本的变动。 打包AB时,需要在AB名称中附带hash,以便于微信管理下载缓存:用代码打包AB,请添加 BuildAssetBundleOptions.AppendHashToAssetBundleName 选项。

8、安装微信开发者工具

下载微信开发者工具

找到Unity导出工程中的minigame目录,使用微信开发者工具导入。

888888.png

9、手机预览调试

点击 [预览] 按钮生成二维码,用手机扫二维码即可访问小游戏。只能用申请AppID的微信账号扫码测试。如果需要分享二维码给其他人,需要申请正式的小游戏AppID,并在微信后台添加测试人员的微信账号。

111111.png

如果加载资源失败,点击手机右上角的[...],再选择“开发调试”。

222222.png

异常报错

启动工程时报 D3DCompiler_47.dll 无法访问。

Fatal Error.png

原因:安装Unity时360阻止了一些模块安装。

解决方案:

  删除缓存资源包 C:\Users\{自己的系统账号名}\AppData\Local\Temp\unityhub-xxxxxx,卸载Unity,并重新安装。

Tianjie缓存路径.png

10、测试官方小游戏示例

微信搜索“小游戏示例”。官方小游戏展示了所有游戏能力接口。

https://github.com/wechat-miniprogram/minigame-demo

111111.png

222222.png

标签: Unity3d

Powered by emlog  蜀ICP备18021003号-1   sitemap

川公网安备 51019002001593号