目录
Unity 工具之 UniWebView 内嵌网页/浏览器到应用中,并且根据UGUI大小放置(简单适配UGUI)
一、简单介绍
二、UniWebView 组件上的几个参数属性选项介绍
三、一些关键接口介绍
四、Transition
五、Memory Management(内存管理)
六、Messaging System
七、注意实现
八、效果预览
九、实现 通过UGUI控制 WebView 大小的使用的具体步骤
十、关键代码
十一、参考工程
一、简单介绍
Unity 工具类,自己整理的一些游戏开发可能用到的模块,单独独立使用,方便游戏开发。
本节介绍,使用 UniWebView 内嵌网页/浏览器到应用中,并通过 UGUI 控制 Web View 大小显示的方法。方法不唯一,这里仅供参考。
UniWebView 包含一组 C# 的高层级 API,它对 iOS 和 Android 平台的本机 API 进行了抽象封装。使用 UniWebView,您可以在无需了解本机开发的任何内容的情况下,就将浏览器行为添加到游戏中。当您需要显示活动公告及通知,或为玩家排名添加排行板,或是向用户显示任何网页内容时,UniWebView 都可以帮助您轻松解决问题。
UniWebView 支持 在iOS 9.0 或更高版本,以及 Android 5.0 (API Level 21) 或更高版本。它还包含在 macOS 上的 Unity Editor 的完整功能支持。
功能:
网络浏览
载入本地 HTML 文件
JavaScript 完整支持
基于 url scheme 的消息系统
通过绝对值或引用 Unity UI 元素的相对值来设置位置和大小
播放 YouTube,Vimeo 或本地视频
获取照片和上传
注意:UniWebView 使用版本为 UniWebView 3.7.0
二、UniWebView 组件上的几个参数属性选项介绍
1、Url On Start
在UniWebView的Start() 方法里会加载url
2、Show On Start
勾选的话会在Start()方法里主动显示。
未勾选的话需要主动调用Show()方法
3、Full Screan
全屏展示,勾选上的话会忽略Frame 和 Reference Rect Transform的设置
4、使用固定大小展示的话 设置 Frame的值,并且取消勾选Full Scream,以及
Reference Rect Transform 设置为None
5、Reference Rect Transform
引用一个Rect Transform并更改web view的大小以遵循该转换。如果您正在使用具有多个分辨率支持的Unity UI,那么它是非常有用的。
6、Use Toolbar
勾选后只在ios已经mac上有用。包括关闭,前进,返回等。可以设置Toolbar Position 为Top,则在顶端显示,Bottom 则在底端显示。android的导航栏就有这些功能,所以不需要这个。
7、一旦UniWebView被Done按钮或Back按钮关闭,它将在默认情况下销毁组件本身,以便尽快释放资源。您将无法重用相同的UniWebView。如果想要显示另一个页面,则需要创建一个新的UniWebView。
三、一些关键接口介绍
1、OnPageFinished 当url加载完毕后调用
也可以使用方法作为委托侦听器(delegate Listener)
参考: https://msdn.microsoft.com/en-us/library/018hxwa8.aspx
2、OnShouldClose
OnShouldClose是在web视图即将关闭时发送给您的事件。用户可以使用iOS上的“完成”按钮或Android上的“后退”按钮。一旦web view关闭,UniWebView组件也将被销毁,以保持干净。如果您在引用中保存web视图(例如,我们在这里通过webView字段保存web视图),那么很有可能将其设置为null。否则,如果你想要加入的话,你以后可能会遇到麻烦。
tips:
在Android上,“后退”按钮将引导用户返回到上一个页面。如果没有返回的页面,它将发送OnShouldClose事件,如果返回true,则尝试关闭web view。
3、EvaluateJavaScript 调用 JavaScript 方法
第一个参数:JavaScript 的方法
第二个参数:第二个参数是带有UniWebViewNativeResultPayload的操作。payLoad也用于其他web view的方法回调,其中包含来自本机端的基本信息。这里我们只需要检查下状态码,“0”表示一切正常。
4、OnMessageReceived
html里需要有
四、Transition
1、显示/隐藏过渡
通过修改Show 和 Hide的参数
fade 淡入淡出效果
edge 出现/消失的方向 eg:UniWebViewTransitionEdge.Bottom 从底部出现
duration 持续时间
completionHandler:完成后回调
tip:这两个方法有个bool返回值,每次只允许进行一个转换,如果您试图在上一个转换打开时初始化另一个转换,那么新的转换将不会启动,返回值将为false。
2、Web View Animation
UniWebView还支持在显示web视图时对其进行动画处理。使用AnimateTo方法,就可以指定一个帧作为目标帧。通过使用此方法,您还可以设置动画的持续时间和延迟,以便进行精细的控制。
五、Memory Management(内存管理)
1、在不需要时销毁web视图
2、如果web视图的holder组件(本例中为MyMonoBehaviour组件)有可能被破坏,您可能还需要在MyMonoBehaviour中添加OnDestroy,并关闭web视图以防止泄漏:
3、将一个监听器添加到OnShouldClose事件中,在关闭用户操作的web view时,Android和iOS将调用该事件。
tip:如果return false , 视图不会被关闭。OnShouldClose让我们有机会重写关闭方法。
4、在使用webView的MyMonoBehaviour网站的其他部分,你可以在使用webView之前检查它是否为null:
5、在不使用时清理缓存
当用户浏览Internet时,它将创建一些缓存,包括缓存的图像和响应,或者web页面将一些内容存储在本地存储中。虽然在大多数情况下它不会占用内存,但是如果您没有在这种情况下使用缓存,您可以调用CleanCache清除它们。
六、Messaging System
1、UniWebView通常情况下检查所有从"uniwebview://"启动的链接。OnMessageReceived事件将会收到UniwebViewMessage object
UniWebView消息传递系统还可以帮助您解析输入
2、添加你自己的scheme
3、也可以设置"http"和"https"作为一个scheme,它将阻止所有web资源的加载并将它们发送给您。这给了一个检查所有交通的机会。
eg:它的一个用例是您不希望您的用户离开当前页面。因此,您可以首先加载您的页面,然后在OnPageFinished事件中,通过向UniWebView消息系统添加“http(s)”方案来禁用所有导航:
4、消息系统构建在URL和Unity的消息发送器上。这意味着您不能同时发送无限大小的数据。URL的最大允许长度与设备和系统版本不同。但是一个URL的安全长度是~16KB。如果你有什么大的东西从网页发送到Unity并且遇到一些问题,最好把它们分成小块。
更多接口信息可到官网,或者查看插件的接口说明,这里不再赘述
七、注意实现
1、由于UniWebView 是贴屏显示的,所以在UGUI中的的UI组件在Web显示后会被覆盖掉
2、由于UniWebView 是贴屏幕显示,所以在AR/VR 3D世界中使用不是很有好
3、UniWebView 不支持 PC端,所以请打包到 Android 或者 IOS 设备上运行
八、效果预览
九、实现 通过UGUI控制 WebView 大小的使用的具体步骤
1、打开Unity,导入 UniWebView 插件
2、在场景中搭建 UI
3、新建脚本,编写脚本,并添加到 UI 控件上,对应赋值脚本
4、添加 UniWebView 脚本给 Web_Image,把Web_Image 赋值 UniWebView 的 Reference Rect Transform,这样 Web_Image ,并且取消 Full Screen ,这样就可以控制 Web View 大小随 Web_Image 了
5、打包,到设备上运行,效果如下
十、关键代码
1 | using System.Collections; |