Unity 之 发布WebGL转微信小游戏过程详解

2,173

前言

用 Unity WebGL 小游戏适配(转换)方案,本方案设计目的是降低 Unity 游戏转换到微信小游戏的开发成本。基于WebAssembly技术,无需更换Unity引擎与重写核心代码的情况下将原有游戏项目适配到微信小游戏。

效果展示

一,准备工作

1.1 下载插件

进入官方GitHub地址,找到安装与使用 -- Unity插件, 也可直接点击下载,下载完成后是.unitypackage的包:


1.2 下载Unity

我这里用的是Unity2021.3.3f1c1版本:

下载时需要添加:WebGL Build Support 模块:

官方提示:转微信小游戏插件已验证Unity版本:2018、2019、2020、2021(请尽量使用LTS, 推荐使用2019、2021)。使用Big Sur版本Mac系统的童鞋,在使用2019.4.14之前的版本,会遇到些问题,则需另外安装 python3,并安装brotli 命令如下: python3 -m pip install brotli

若你没有安装过,则等着进度条走完即可:

若已安装,则会显示python3的版本号:


1.3 安装微信开发者工具

点击进入,微信小游戏开发工具页,根据系统选择下载工具,然后安装到本地。

打开后大致长这个样子:


1.4 创建小程序

点击进入,小游戏注册页,每个邮箱仅能申请一个小程序,按照要求填写信息:

注册完成后,点击登录。然后完成小程序信息小程序类目的信息补充。

小程序信息:按照你的需求填写即可

小程序类目:类目设置为"游戏",若不设置则后续使用此Appid打开时,否则开发工具会自动将你的项目转化成小程序。

最后,在后台界面往下滑,左侧找到”开发工具“ --> 获取AppID

目前的设置,已经满足测试需求了。


二,开始转换

2.1 创建项目

使用刚刚下载的新版本Unity创建一个Webgl平台的项目:

打开后,将1.1下的插件导入到工程中,导入后工程目录如下:

2.2 Mac适配

若使用的不是Mac可直接跳到2.3。

2019.4.13f1 版本:

使用Big Sur版本Mac系统的童鞋,在使用2019.4.14之前的版本,会遇到些问题,则需另外安装 python3,在上面1.2已经说了,没安装的话,再去看一下。

Mac版本打包之前,找到微信小游戏菜单,点MacOS脚本授权

  1. 提示:无法打开“PVRTextoolCLI”,因为无法验证开发者。点击取消:

    会在设置 “安全与隐私” -> "通用" 点击 仍然允许 。 后的2,3同样处理

  2. 提示:无法打开“pngquant”,因为Apple无法检查其是否包含恶意软件。

  3. 提示:无法打开“brolib_x64.dylib”,因为无法验证开发者。

MacOS脚本授权 成功后会打印一个日志:


2.3 Mac适配的一个问题

【新版SDK官方做了适配,已经没有这个问题了】

我使用2019.4.8f1也遇到了同样的问题,但是使用2021.3.3f1版本就可以弹出下面这个提示,然后“安全与隐私” -> "通用"中允许授权就没问题了。

2019.4.8f1 不知道为什么弹不出来,就一直授权不成功(多操作几次):

MaxOS脚本授权一直失败 -- 我目前也没有解决,只能升级了工程使用的Unity版本,可以点官方issues 看一下,没准你看到的时候,这个问题已经解决了。


2.4 打包报错 需要-x执行权限

发布微信小游戏,权限问题: 在这里插入图片描述

命令行解决:

  1. 查看权限:
ls -l 执行文件目录
  1. 添加权限
chmod +x 文件目录
  1. 验证是否添加成功
ls -l 执行文件目录

在这里插入图片描述


三,发布游戏

3.1 发布设置

点击”转换小游戏“:

会弹出一个设置面板:

填写AppId(在1.4申请的那个),CDN和项目名先随便写一个,选择一个导出路径,将首包资源加载方式转换为小游戏分包,最后点击导出WEBGL并转换为小游戏(常用):

等待导出完成,导出后的目录:

3.2 首次使用

打开微信开发者工具,选择小游戏 --> 导入 --> 选择导出的minigame路径:

打开后,输入上面的AppID,后端服务选择不使用云服务

首次打开,会提示插件未授权使用,双击添加(下次使用就不用添加了)

点击添加即可,添加后需要手动关闭,

3.3 完美运行

等待编译完成,即可看到我么熟悉的Unity的加载动画,然后进入到场景