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

Unity 之 发布WebGL转微信小游戏

  • 前言
  • 一,准备工作
    • 1.1 下载插件
    • 1.2 下载Unity
    • 1.3 安装微信开发者工具
    • 1.4 创建小程序
  • 二,开始转换
    • 2.1 创建项目
    • 2.2 Mac适配
    • 2.3 Mac适配的一个问题
    • 2.4 打包报错 需要-x执行权限
    • 2.5 资源文件过大
    • 2.6 常见问题
  • 三,发布游戏
    • 3.1 发布设置
    • 3.2 首次使用
    • 3.3 完美运行

前言

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

效果展示

Unity 之 发布WebGL转微信小游戏过程详解_第1张图片

一,准备工作

1.1 下载插件

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

Unity 之 发布WebGL转微信小游戏过程详解_第2张图片


1.2 下载Unity

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

下载时需要添加:WebGL Build Support 模块:
Unity 之 发布WebGL转微信小游戏过程详解_第3张图片

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

若你没有安装过,则等着进度条走完即可:
Unity 之 发布WebGL转微信小游戏过程详解_第4张图片

若已安装,则会显示python3的版本号:
Unity 之 发布WebGL转微信小游戏过程详解_第5张图片


1.3 安装微信开发者工具

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

Unity 之 发布WebGL转微信小游戏过程详解_第6张图片

打开后大致长这个样子:
Unity 之 发布WebGL转微信小游戏过程详解_第7张图片


1.4 创建小程序

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

Unity 之 发布WebGL转微信小游戏过程详解_第8张图片

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

Unity 之 发布WebGL转微信小游戏过程详解_第9张图片

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

Unity 之 发布WebGL转微信小游戏过程详解_第10张图片

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

Unity 之 发布WebGL转微信小游戏过程详解_第11张图片

最后,在后台界面往下滑,左侧找到”开发工具“ --> 获取AppID
Unity 之 发布WebGL转微信小游戏过程详解_第12张图片

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


二,开始转换

2.1 创建项目

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

Unity 之 发布WebGL转微信小游戏过程详解_第13张图片

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

Unity 之 发布WebGL转微信小游戏过程详解_第14张图片

2.2 Mac适配

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

2019.4.13f1 版本:
Unity 之 发布WebGL转微信小游戏过程详解_第15张图片

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

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

Unity 之 发布WebGL转微信小游戏过程详解_第16张图片

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

    Unity 之 发布WebGL转微信小游戏过程详解_第17张图片

    会在设置 “安全与隐私” -> “通用” 点击 仍然允许 。 后的2,3同样处理
    Unity 之 发布WebGL转微信小游戏过程详解_第18张图片

  2. 提示:无法打开“pngquant”,因为Apple无法检查其是否包含恶意软件。
    Unity 之 发布WebGL转微信小游戏过程详解_第19张图片

  3. 提示:无法打开“brolib_x64.dylib”,因为无法验证开发者。
    Unity 之 发布WebGL转微信小游戏过程详解_第20张图片

MacOS脚本授权 成功后会打印一个日志:
Unity 之 发布WebGL转微信小游戏过程详解_第21张图片


2.3 Mac适配的一个问题

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

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

Unity 之 发布WebGL转微信小游戏过程详解_第22张图片

2019.4.8f1 不知道为什么弹不出来,就一直授权不成功(多操作几次):
Unity 之 发布WebGL转微信小游戏过程详解_第23张图片

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


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

发布微信小游戏,权限问题:
Unity 之 发布WebGL转微信小游戏过程详解_第24张图片

命令行解决:

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

Unity 之 发布WebGL转微信小游戏过程详解_第25张图片


2.5 资源文件过大

使用包内加载时,资源过大打包完成后会提示:
Unity 之 发布WebGL转微信小游戏过程详解_第26张图片
使用微信开发工具打开导出的文件会报错:
Unity 之 发布WebGL转微信小游戏过程详解_第27张图片

解决方法:将首包资源加载方式修改为:CDN,然后将资源上传到CDN地址即可。
Unity 之 发布WebGL转微信小游戏过程详解_第28张图片
将打包出来的webgl文件夹下所有资源都上传到上面指定的CDN目录下:
Unity 之 发布WebGL转微信小游戏过程详解_第29张图片

2.6 常见问题

官方技术常见问题QA,点击查看更多

Unity 之 发布WebGL转微信小游戏过程详解_第30张图片
Unity 之 发布WebGL转微信小游戏过程详解_第31张图片


三,发布游戏

3.1 发布设置

点击”转换小游戏“:
Unity 之 发布WebGL转微信小游戏过程详解_第32张图片

会弹出一个设置面板:

填写AppId(在1.4申请的那个),CDN和项目名先随便写一个,选择一个导出路径,将首包资源加载方式转换为小游戏分包,最后点击导出WEBGL并转换为小游戏(常用):
Unity 之 发布WebGL转微信小游戏过程详解_第33张图片

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

Unity 之 发布WebGL转微信小游戏过程详解_第34张图片

3.2 首次使用

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

Unity 之 发布WebGL转微信小游戏过程详解_第35张图片

Unity 之 发布WebGL转微信小游戏过程详解_第36张图片

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

Unity 之 发布WebGL转微信小游戏过程详解_第37张图片
若不消息打开了微信云开发,在打开后的界面点 “云开发” 按照下面操作进行删除,然后重新进入即可:
Unity 之 发布WebGL转微信小游戏过程详解_第38张图片Unity 之 发布WebGL转微信小游戏过程详解_第39张图片Unity 之 发布WebGL转微信小游戏过程详解_第40张图片
Unity 之 发布WebGL转微信小游戏过程详解_第41张图片


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

Unity 之 发布WebGL转微信小游戏过程详解_第42张图片

点击添加即可,添加后需要手动关闭,
Unity 之 发布WebGL转微信小游戏过程详解_第43张图片

Unity 之 发布WebGL转微信小游戏过程详解_第44张图片

3.3 完美运行

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

Unity 之 发布WebGL转微信小游戏过程详解_第45张图片

你可能感兴趣的:(ジ﹋★☆『,引擎进阶,』,ジ﹋★☆『,经典示例,』,unity,微信,游戏引擎)