基于Unity+Vue3通信交互的WebGL项目发布实践
问题背景
我们最近需要把unity开发的pc项目迁移到web端,因为unity支持发布webgl。所以按照以往的开发流程,都是项目开发完成就发布webgl部署到服务器。
突然有一天,测试人员提出说为什么我们做的网页跟别人的不太一样呢?具体看下面两张图:
1、unity使用ugui做的界面发布webgl渲染的出来的样子
2、别人前端采用vue开发的UI界面。
直观从这两个截图来看还是可以看出unity的ugui在网页端渲染出来比较糊,不清晰。而且从实际体验中ugui的输入框在网页中极其不好用,还有诸多ui上的问题…唉,比较unity的优势不在web端,而且本来它为了性能考虑,在渲染ui方面肯定是比不上这些原生应用的。
所以,我们最终采用vue3开发前端UI界面的方案代替unity的UGUI界面。下面我们就一起来探讨一下Vue和Unity是怎么一起共同配合工作的吧!
准备工作
阅读下文之前,你除了需要具备Unity发布WebGL的知识之外,可能还需要具备一些前端方面的知识,比如"三剑客":Html、Css、JavaScript,当然如果能熟悉Vue方面的知识就更好了。这样你就能畅通无堵的阅读本文了。
解决方案
1、vue项目中安装unity-webgl插件。
2、vue直接通过SendMessage方法向Unity发送消息。
3、Unity通过jslib脚本中介向Vue发送消息。
4、unity和vue双向通信流程如下:
项目实践
小目标
1、搭建Unity测试项目并发布WebGL部署到Vue项目中。
2、验证Vue向Unity发送信息:通过前端UI控制Unity游戏物体的显隐和修改颜色。
3、验证Unity向Vue发送信息:Unity监听键盘空格键按下触发前端提示框的显示。
搭建Unity测试项目
1、测试场景
2、创建用于Unity与Vue通信的两个重要脚本
-
MessageManager.cs
创建MessageManager游戏物体,挂载MessageManager脚本,脚本提供接口给vue调用。
脚本内容如下:
using UnityEngine;
/// <summary>
/// Unity-Vue消息管理脚本
/// </summary>
public class MessageManager : MonoBehaviour
{
/// <summary>
/// 测试cube游戏物体
/// </summary>
public GameObject cube;
/// <summary>
/// vue设置物体显隐
/// </summary>
/// <param name="visible"></param>
public void Vue_SetVisible(string visible)
{
if (cube != null)
{
cube.transform.localScale = visible == "0" ? Vector3.zero : Vector3.one;
}
}
/// <summary>
/// vue设置颜色
/// </summary>
/// <param name="htmlColor"></param>
public void Vue_SetColor(string htmlColor)
{
if (cube != null)
{
if (ColorUtility.TryParseHtmlString(htmlColor,out Color color))
{
cube.GetComponent<MeshRenderer>().material.color = color;
}
}
}
}
- webgl.jslib
注意📢 :Unity官方文档中有说明,请使用 .jslib
扩展名将包含 JavaScript 代码的文件放置在 Assets 文件夹中的“Plugins”子文件夹下。所以一般的做法就是在Plugins下新建文本文档,然后改名字改后缀即可。该jslib文件需符合Js语法,否则发布webgl会报错。
jslib脚本格式内容如下:
mergeInto(LibraryManager.library, {
ShowDialog: function (str) {
var tip = UTF8ToString(str);
// '__UnityLib__' 是插件提供的unity对象,相当于绑定了网页渲染出来的Unity容器
__UnityLib__.showDialog(tip);
},
});
那么Unity怎么调用jslib中的方法呢?
C#为我们提供了这个命名空间System.Runtime.InteropServices下的DllImport方法,允许引入非托管代码程序集,也就是说我们在Unity里可以通过DllImport方法调用外部程序集的方法。
这里为了测试方便,我就直接将Unity调用jslib的方法写在MessageManager里面了。
using UnityEngine;
using System.Runtime.InteropServices;
/// <summary>
/// Unity-Vue消息管理脚本
/// </summary>
public class MessageManager : MonoBehaviour
{
[DllImport("__Internal")]
private static extern void ShowDialog(string msg);//方法名需要jslib书写一致
private void Update()
{
if (Input.GetKeyDown(KeyCode.Space))
{
ShowDialog("来自Unity的消息");
}
}
}
至此完成Unity项目的搭建,将项目发布成webgl包,部署到vue项目中测试。
创建Vue3测试项目
1、创建vue3项目,并安装unity-webgl插件
创建vue3项目这里就不再赘述了,自行搜索相关教程,如有必要,后期再考虑出相关教程。
使用npm安装unity-webgl插件,执行以下命令:
npm install unity-webgl
安装成功可在vue项目下node_modules看到unity-webgl。
2、创建vue3组件UnityGame.vue用于渲染unity画布
vue组件一般我们就放在components文件夹下,vue默认的资源文件夹目录是public,所以我们在public下新建Unity文件夹用于部署unity发布出来的webgl包内容。
UnityGame.vue内容如下:
<template>
<VueUnity :unity="unityContext" width="800" height="600"></VueUnity>
</template>
<script setup>
import UnityWebgl from 'unity-webgl';
import VueUnity from 'unity-webgl/vue';
const unityContext = new UnityWebgl({
loaderUrl: '/Unity/UnityVue.loader.js',
dataUrl: '/Unity/UnityVue.data.gz',
frameworkUrl: '/Unity/UnityVue.framework.js.gz',
codeUrl: '/Unity/UnityVue.wasm.gz',
})
unityContext.on('mounted',() => console.log('Unity加载完成...'))
</script>
注意📢 :配置项必须包含最基本的四个属性loaderUrl
, dataUrl
, frameworkUrl
, codeUrl
,这四个属性都是初始化 Unity 应用程序所需的资源文件。
我们还需要再App.vue注册并渲染UnityGame.vue组件:
<template>
<UnityGame />
</template>
<script setup>
import UnityGame from './components/UnityGame.vue'
</script>
这样我们使用vue部署unity项目的基本结构就完成了。
执行命令:npm run dev
打开本地服务器地址:http://localhost:5173/,即可看到我们用vue部署的unity webgl项目。
3、vue中实现与unity通信的基础
unity-webgl插件为我们提供了两个关键方法:
-
vue调用unity方法
send(objectName: string, methodName: string, params?: any)
⭐️ 向Unity实例对象发送消息,调用一个公共方法。
-
objectName
: Unity场景中对象的名称 -
methodName
: Unity脚本中方法的名称 -
params
: 传递的参数
-
-
unity调用vue方法
on(eventName: string, eventListener: Function)
⭐️ 注册一个事件或方法,用于监听触发事件或供Unity脚本调用。
所以,我们需要在UnityGame组件里添加实现unity与vue通信交互的测试代码。
我们将通信的方法写在UnityGame.vue组件里。示例:
<template>
<VueUnity :unity="unityContext" width="800" height="600"></VueUnity>
<div style="width: 50%; margin-left: auto; margin-right: auto;">
<button @click="onShowCube" class="defaultButton">{{visible ? '隐藏':'显示'}}</button>
<button @click="onSetColor" class="redButton"></button>
<button @click="onSetColor" class="blueButton"></button>
<button @click="onSetColor" class="yellowButton"></button>
</div>
</template>
<script setup>
import UnityWebgl from 'unity-webgl';
import VueUnity from 'unity-webgl/vue';
import {ref} from 'vue';
//构建unity实例对象
const unityContext = new UnityWebgl({
loaderUrl: '/Unity/UnityVue.loader.js',
dataUrl: '/Unity/UnityVue.data.gz',
frameworkUrl: '/Unity/UnityVue.framework.js.gz',
codeUrl: '/Unity/UnityVue.wasm.gz',
})
const visible = ref(true)
unityContext.on('mounted',() => console.log('Unity加载完成...'))
.on('showDialog',(tip)=> alert(tip))//监听unity调用的方法
//向Unity发送信息
function postUnityMessage(methodName, arg) {
unityContext.send('MessageManager', methodName, arg)
}
//调用unity的方法
//设置cube显隐
function onShowCube(){
visible.value = !visible.value;
postUnityMessage('Vue_SetVisible',visible.value ? "1" : "0")
}
//设置cube颜色
function onSetColor(event){
const button = event.target;
const style = window.getComputedStyle(button);
const htmlcolor = rgbtohex(style.backgroundColor.toString());
postUnityMessage('Vue_SetColor',htmlcolor);
}
function rgbtohex(rgb){
// rgby颜色值的正则
var reg = /^(rgb|RGB)/;
// 判断是否为rgb格式
if(reg.test(rgb)){
// 将rgb的三个数值切割成数组 rgb(255,0,0) ——> ["255","0","0"]
var colorArr = rgb.replace(/(?:rgb|RGB|\(|\))*/g,"").split(',');
var hex = "#" + ((1 << 24) + (parseInt(colorArr[0]) << 16) + (parseInt(colorArr[1]) << 8) + parseInt(colorArr[2])).toString(16).slice(1);
return hex;
}else{
return rgb
}
}
</script>
<style>
.defaultButton{
width: 50px;
height: 50px;
}
.redButton{
background-color: red;
width: 50px;
height: 50px;
}
.yellowButton{
background-color: yellow;
width: 50px;
height: 50px;
}
.blueButton{
background-color: blue;
width: 50px;
height: 50px;
}
</style>
至此,vue测试通信unity项目构建完成。
运行项目验证unity和vue通信功能
1、unity打开vue的前端提示框。
2、vue前端UI按钮点击事件控制unity游戏物体的显隐和设置颜色。
ok,我们已经完成本次实践目标。
总结与展望
unity发布的webgl,使用UGUI在界面显示和处理用户输入方面存在体验差的问题。这些都可以用vue来解决。其实就是使用vue开发前端页面代替unity的UGUI界面,充分发挥了vue的优势,也保留了Unity渲染3d部分的优势。当前这就需要unity开发人员同时具备vue开发前端方面的知识了。
当我们开发前端的项目时,如果同时需要2d界面和3d场景交互时,如数字孪生、虚拟仿真等数据可视化项目,采用Unity+Vue3技术开发是个不错的选择!文章来源:https://www.toymoban.com/news/detail-853868.html
本文对基于Unity+Vue3的WebGL项目发布实践做了一个测试demo演示unity与vue通过第三方插件unity-webgl通信的流程。需要对你有所帮助哦!创作不易,如果合你胃口,来个三连支持吧!我们一起加油!文章来源地址https://www.toymoban.com/news/detail-853868.html
到了这里,关于基于Unity+Vue3通信交互的WebGL项目发布实践的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!