行业新闻

unity 浏览器插件【embedded browser(原zfbrowser)】简单教程,使unity支持web h5页面,附软件下载链接

2024-04-02 阅读次数:

一 简介

这是个在项目中使用了很久的浏览器插件。
很负责任的说这是在pc平台上最好用的浏览器插件
商业付费价格78刀,相比3d webview等插件动不动就178、368的价格就显得很良心
最新版下载链接(请勿商用)

1.1 功能概述

基本和普通浏览器无异

  1. 支持调试台Devtools功能
  2. 支持evil js
  3. 支持h5 原生视频播放
  4. 支持控制台捕获
  5. 支持unity to js, js to unity通信
  6. 支持鼠标键盘事件
  7. 支持各种浏览器操作,包括前进后退刷新打印复制剪切粘贴等
  8. 支持多窗口
  9. 支持vr输入
    还有很多功能等你慢慢发现
1.2 安装

与其他unity插件相同,下载解压后双击即可完成安装。安装完成后project窗口会多出个ZFbrowser文件夹。demo目录下有测试场景。

二 使用教程

2.1 准备工作
  1. 在场景中添加ui canvas 和 RawImage物体
  2. 在RawImage物体中添加以下组件,这几个组件分别是:浏览器主题组件Browser,虚拟鼠标交互组件 Pointer UIGUI,箭头显示组件 Cursor Renderer OS

    3 再新建个c#脚本BrowserMessager 作为组件放到该物体上
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using ZenFulcrum.EmbeddedBrowser;

[RequireComponent(typeof(Browser))]
public class BrowserMessager : MonoBehaviour
{
    private Browser browser;

    void Start()
    {
    	// 获取当前物体上的Browser组件
        browser = GetComponent<Browser>();
    }
}
2.2 加载外部网址
  1. 在刚才新建的脚本中添加加载外部网址方法“browser.LoadURL()”
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using ZenFulcrum.EmbeddedBrowser;

[RequireComponent(typeof(Browser))]
public class BrowserMessager : MonoBehaviour
{
    private Browser browser;

    void Start()
    {
        browser = GetComponent<Browser>();
        // 跳转到百度首页
		browser.LoadURL("www.baidu.com",true);
    }
}

直接运行即可看到百度首页

2.2 直接运行html代码

调用“browser.LoadHTML()”方法

browser.LoadHTML("这是个html代码

html内容

"
);
2.3 加载unity本地html文件

加载本地文件有三个情况:

  1. 加载unity工程里的网页资源
  2. 加载assetbundle打包的网页资源
  3. 加载本地硬盘的网页资源
2.3.1 加载unity工程里的网页资源

1 首先在Assets平级目录中建立BrowserAssets文件夹。注意是平级,不是下级!

2 将创建好的html页面和其他资源扔进去

3 在browser组件的url 设置中改为 localGame://demo/1.html
localGame会自动定位到BrowserAssets目录。 demo是我建的文件夹。1.html就是要运行的网页

注意:
如果网页里面有同文件夹的资源调用别忘了去掉"/"。 例如下面代码,如果是外部网页资源应该加上斜杠, 。如果是本地资源就应该去掉斜杠

DOCTYPE html>
<html lang="en">
<head>
head>
<body>
    <img id = "img" src="图.png" alt=""> 
body>
html>
2.3.2 加载assetbundle打包的网页资源
2.3.3 加载本地硬盘的网页资源

加载本地硬盘的网页资源还用我说了吗,要么起个服务直接给网址,要么使用system.io找到文件地址

三 unty与html通信

网页js与unity通信,至少需要分别实现html和c#两个脚本

3.1 通信:HTML => UNITY

html代码可以按上文所述放置在本地或服务器上。c#脚本作为组件添加到某物体上

html代码
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
	// 创建一个按钮,绑定方法"jsevent"
    <button type="button" onclick="jsevent()">点击按钮通信给unity</button>  
    <script type="text/javascript">
        function jsevent() {
				 console.log("传参");
		}
    </script>
</body>
</html>
c#代码
using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using ZenFulcrum.EmbeddedBrowser;
using ZenFulcrum.EmbeddedBrowser.VR;

[RequireComponent(typeof(Browser))]
public class BrowserMessager : MonoBehaviour
{
    private Browser browser;
    void Start()
    {
        browser = GetComponent<Browser>();
        //监听html 中的jsevent方法
        browser.RegisterFunction("jsevent", (JSONNode jv) =>
        {
        	// js多参数输入
            Debug.Log(jv[0].Value);
        });
    }
}

点击通信按钮

unity这边就捕获到了信息

捕获信息也可以在html那边直接用console.log打印出来,然后在c#中调用

browser.onConsoleMessage += (string s1, string s2) => {
    Debug.Log("js console info:" + s1 + s2);
};

直接捕获控制台数据。不过为了区分数据需要添加数据组合规则较麻烦。

3.2 UNITY => HTML

js代码:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>
<body>
    <script type="text/javascript">
    	//被unity调用的函数
		function unityevent(item) {
			console.log("unity参数:",item);
		}
    </script>
</body>
</html>

c#代码

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using ZenFulcrum.EmbeddedBrowser;
using ZenFulcrum.EmbeddedBrowser.VR;

[RequireComponent(typeof(Browser))]
public class BrowserMessager : MonoBehaviour
{
    private Browser browser;
    void Start()
    {
        browser = GetComponent<Browser>();
    }
    private void Update()
    {
        if (Input.GetKey(KeyCode.Space))
        {
            browser.CallFunction("unityevent", "unity to js").Done();
        }
    }
}

执行程序号,按下space按键,即可看到js代码中unityevent所打印的参数了

四 其他api

直接执行js代码
browser.EvalJS("console.warning(\"this is jscode\")");
监听浏览器控制台输出
browser.onConsoleMessage += (string s1, string s2) => {
    Debug.Log(s1 + "====" + s2);
};
直接跳转到网址
browser.LoadURL("www.baidu.com",true);
直接执行html代码
browser.LoadHTML("123123

html代码

"
);
网页完成加载时触发的事件
        browser.onLoad += (JSONNode jn) => {
            Debug.Log("浏览器完成加载");
        };