Unity生成小米快游戏介绍

侯壮壮

已于 2024-06-17 15:02:38 修改

阅读量469

点赞数 22

文章标签：游戏 unity 游戏引擎

于 2024-06-12 14:23:11 首次发布

本文链接：https://blog.csdn.net/u013965885/article/details/139625552

版权

工具下载链接：http://tennews.cn/unity/use.pdf

github：https://github.com/houqingfeng/unitytomiqgame

第1部分工具导入

注意：导入之后如果遇见EditorCoroutines的错误，安装相应的package包即可。

说明：工具包含两个面板：转快游戏和wasm-split。

转快游戏是把unity工层转换成小米快游戏工程，并且生成最终rpk。
wasm拆分是优化工具，用来对wasm文件做拆分。加快首包加载速度和降低首包内存。

准备工作就这么多，下面是使用！

第2部分环境装备

必选安装：

安装nodejs：用来生成rpk包。（必须安装）
安装快应用开发IDE：用来打开快应用工程，开发和调试。
1. 安装方法：打开快应用官网安装，下载安装即可！

强烈建议安装：

安装android studio：优化使用，用来做wasm拆包，也可以用来看日志！（android studio也需要安装一下，也是用来调试的，建议安装！）

第3部分使用

参数设置：（打开面板）

当中会出现一段时间白屏状态，为了用户体验，需要加载一种游戏loading图片，建议一定要加上！！！（类似这种的loading图片）

这两个地址可以暂时不填写，如果生成的包体不超过20M，可以不用填写。
1. 游戏名称。（正常填写）
2. 包名：包名一定要用快应用开发者平台注册的包名，否则会出现资源加载失败的页面！！！
  
  如果没有注册过的包名，可以先用测试包名com.demo.ch.mini进行开发。
3. 版本号：字符类型，一般为1.0.2.11这种格式。
4. 版本code：数字类型
5. 自定义Loading链接：unity类型的游戏在快应用里面启动是需要先加载编译wasm文件，在这个过程
6. 输出目录：设置输出目录，保证这个目录没有被其他应用打开。如果遇见打包失败的提示，可以看下这个输出目录是否被其他应用正在使用。（确保输出目录没有其他应用打开）
7. 游戏屏幕方向。
8. nodejs版本：高版本nodejs打包使用的加密方式和低版本有所不同，可以使用 node -v 查看版本号。
9. 包类型：debug开发版本，release上线版本。秘钥生成：可以使用快应用IDE生成
  1. debug和release的秘钥可以用一样的，把秘钥放在一个能找到的地方就可以。
10. build.data和build.wasm说明（这两个文件是unity web游戏的核心文件）
  1. build.data是游戏的资源存放文件
  2. build.wasm是游戏的代码存放文件
11. StreamingAssets根据游戏的情况来定，如果有用到设置上地址就可以。（我们没用到就不填了）
12. 点击生成快游戏
13. 打包过程当中，等待打包完成即可。
14. 如果遇见没有选scene之类的问题是因为没有选定打包scene和切换webgl平台！！！
15. 生成结果：
  1. 生成目录包含dist文件夹，里面有相应的rpk，即表示生成成功！

第4部分启动和调试

启动准备工作：
1. 只能用小米真机启动
2. 需要安装快应用调试器，下载完apk安装到手机上即可，打开apk如下画面
3. 选择小米快游戏服务器框架：com.miui.hybrid（有很多框架，这个框架才是快游戏的，一定要选择这个，其他的不能启动快游戏！）
启动：
1. 用快用IDE打开转化之后的工程。把生成目录下的MiQGame文件夹打开，这个就是转换之后的快游戏工程！
2. 执行命令 npm run build 或者 npm run release （build是生成debug包的，release生成线上包）执行之后重新生成rpk
3. 执行 npm run server生成二维码
4. 手机扫码安装，手机需要和电脑处于同一个局域网下！这个图片就是自定义loading页面
调试
1. 手机开启usb调试，开启usb调试的方法：如演示一直点os版本或者miui版本会进入开发者模式，
  
  打开开发者选项 usb调试 usb安装都打开
2. 打开edge浏览器（建议用edge浏览器），输入：edge://inspect/#devices 等一会，显示usb连接的手机
3. 在把游戏起来
4. 等游戏进入到游戏里面在点击inspect，就可以看到日志信息了

第5部分优化

包体过大优化

快游戏平台规定包体最大20M，30M超标了，优化一下，优化方法如下：

可以选择把build.data和build.wasm其中一个或者两个都放在服务器

build.data过大，那就把build.data放在服务器上。以本地服务器演示使用方法

设置好服务器地址，重新打包
生成完了工程，需要把build.data放到服务器上，服务器起来了，在把游戏起来
我们设置的build.data地址看看能访问把，可以正常访问，打包->扫码安装
可以看到是从网络加载的这个资源，一样能正常进入游戏
wasm如果过大也可以用同样的方法放在服务器上即可！