Unity网页游戏是跑在浏览器的UnityWebPlayer插件中的,运行的模式是webplayer.unity3d+html

在嵌入UnityWebPlayer的网页中会调用UnityObject2的initPlugin函数,将webplayer.unity3d作为参数传入来初始化Unity网页游戏的运行环境

注:游戏dll及其他托管dll在构建Web版本时都会写入到webplayer.unity3d文件中

 

拥有检测 Unity Web Player插件、初始化其安装和嵌入 Unity 内容的函数。可以将 UnityObject2.js 文件与 HTML 文件一起部署到网络服务器,

但最好是从 Unity 服务器中直接加载,地址为:http://webplayer.unity3d.com/download_webplayer-3.x/3.0/uo/UnityObject2.js 或 https://ssl-webplayer.unity3d.com/download_webplayer-3.x/3.0/uo/UnityObject2.js(以获得 https 支持)。

这样,您将始终使用到UnityObject2 最新版本。而且托管在 Unity 服务器上的 UnityObject2.js 文件被压缩了,使其变小,节约流量。

在Windows 系统Unity编辑器的Data\Resources 文件夹和 Mac OS X 中的Contents/Resources文件夹中可找到UnityObject2.js 源文件。

 

浏览器支持情况

由于各大浏览器厂商开始逐渐不支持浏览器插件,Unity5.4及之后的版本,UntiyWebPlayer被移除,只提供WebGL导出方式来支持网页游戏。UnityWebPlayer Road Map

支持UnityWebPlayer的浏览器有:

windows平台浏览器 -- IE系列(注:最新为IE11。win10开始使用Edge作为缺省浏览器,Edge是不支持插件的。另外为了访问需要插件的网站,win10也提供了IE浏览器)

mac os x平台浏览器 -- Safari

跨平台浏览器 -- Chrome 45前的版本、Firefox 52.0前的版本、Opera

国产浏览器 -- 如:QQ浏览器、360浏览器等    一般有2个模式:兼容模式(IE)和极速模式(Chrome内核)

                    尽管集成的Chrome内核版本高于45,这些国产浏览器一般都会对集成的Chrome内核做修改,让其能支持NPAPI插件的运行

注1:除了IE是使用ActiveX插件外,其他浏览器都是NPAPI插件

注2:Chrome 42版本开始缺省禁止NPAPI插件,但允许用户手动开启;到45版本则强制禁止了;但flashplayer仍然可以运行:chrome://settings/content/flash

注3:Firefox 52.0版本强制禁止除flashplayer外的所有NPAPI插件

注4:PPAPI和NPAPI说明

PPAPI是专为chrome内核而开发的,能够在各种浏览器、操作系统和移动设备上使用,软件短小精悍,功能强大,兼容性高。NPAPI是当今最流行的插件架构,由Netscape开发后Mozilla维护,几乎支持所有的浏览器,不过它存在很大的安全隐患,插件可以窃取系统底层权限,发起恶意攻击。

2010年,Google在原有NPAPI(Netscape Plugin API)基础上开发了新的PPAPI(Pepper Plugin API),将外挂插件全部放到沙盒里运行,2012年Windows、Mac版本的Chrome浏览器先后升级了PPAPI Flash Player。PPAPI的flash相较于NPAPI来讲,内存占用更大,因为全在沙盒里面运行,而且flash每次更新基本上都是修补安全漏洞。

PPAPI:Opera 15、ChromeNPAPI:适用于FireFox、Safari、Opera 12.17版以下

 

UnityWebPlayer插件

下载地址:https://unity3d.com/cn/webplayer/

https://unity3d.com/cn/webplayer/setup

              http://webplayer.unity3d.com/download_webplayer-3.x/UnityWebPlayer.exe              http://webplayer.unity3d.com/download_webplayer-3.x/UnityWebPlayerFull.exe

              如果需要特定版本的UntiyWebPlayer,可以安装对应的Unity编辑器,在编辑器目录下有对应的UnityWebPlayer.exe安装文件

              形如:D:\Program Files (x86)\Unity\Editor\UnityWebPlayer.exe

unity怎么打开网页 unity加载网页_操作系统

Directory键值记录是UnityWebPlayer的安装目录:%homepath%\AppData\LocalLow\Unity\WebPlayer

un.Directory键值记录是UnityWebPlayer卸载程序Uninstall.exe所在的目录

 

在IE中查询UnityWebPlayer插件的信息与运行状态:

win7 64bit  Internet Explorer9:主菜单 -- 管理加载项

unity怎么打开网页 unity加载网页_操作系统_02

 

从控制面板中卸载UnityWebPlayer插件:

unity怎么打开网页 unity加载网页_ViewUI_03

 

安装后的UnityWebPlayer目录结构   -- 安装在%homepath%\AppData\LocalLow\Unity\WebPlayer

unity怎么打开网页 unity加载网页_unity怎么打开网页_04

player为Unity运行时框架,提供游戏运行的基本环境

mono虚拟机负责解释执行游戏脚本逻辑

loader为浏览器插件:IE下为ActiveX控件(ocx),其他浏览器为NPAPI的dll,Mac为.plugin文件
player\Beta-4.63.x.x\Data\lib及mono\Beta-4.63.x.x\Data\lib中的dll均为托管dll
player\Beta-4.63.x.x\Data\unity default resources及mono\Beta-4.63.x.x\Data\unity_web_old为webplayer资源文件(ui贴图,shader等等)
 
以下为UnityWebPlayer初始化过程中所访问的url链接(使用finddler捕捉到的)
http://10.123.102.142/resources/Client/junhongwang/NZWebTGame.unity3d
http://autoupdate-revision.unity3d.com/revisions.plist?content=http%3a%2f%2f10.123.102.142%2fresources%2fClient%2fjunhongwang%2fNZWebTGame.unity3d&page=http%3a%2f%2f10.123.102.142%2fresources%2fClient%2fjunhongwang%2fNZWebTGame_InnerNew.html&runtime=3.x.x&
http://webplayer.unity3d.com//Channels/a7fe7b7f3d1f/UnityPlayer3.x.x-win32.zip // 会下载到%homepath%\AppData\Local\Microsoft\Windows\Temporary Internet Files\Content.IE5\COFOLVJA\UnityPlayer3.x.x-win32.zip
http://webplayer.unity3d.com//Channels/a7fe7b7f3d1f/Mono3.x.x-win32.zip // 会下载到%homepath%\AppData\Local\Microsoft\Windows\Temporary Internet Files\Content.IE5\C3AYLT70\Mono3.x.x-win32.zip

 

注:UnityWebPlayer.exe仅仅包含loader目录、UnityBugReporter.exe和UnityWebPlayerUpdate.exe文件

     UnityWebPlayerFull.exe除了UnityWebPlayer.exe包含的内容外,还包含mono目录和player目录

     UnityWebPlayer插件在初始化,会根据当前游戏用的runtime版本号,去安装目录中找是否已经存在对应版本的mono和player,若不存在则下载它们

 

运行时临时目录  -- %Temp%\UnityWebPlayer

+---UnityWebPlayer
       +---log
             |           log_bb370ff473d10349836025afd6e6808f.txt   //日志文件
             |           manager_77b9ab931e2f344884b164d4660a0d19.txt
             |
             \---temp
                    \---bb370ff473d10349836025afd6e6808f    // 为了防止多个浏览器实例占用同一份dll,以下3个dll在运行每个实例前都会从UnityWebPlayer安装目录下拷贝
                                       mono-1-vc.dll
                                       webplayer_win.dll
                                       wrap_oal.dll

 

IE临时目录

reg query "HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders" /v Cache

下图为:win7 64bit  Internet Explorer9的缓存目录

unity怎么打开网页 unity加载网页_javascript_05

 

由于UnityWebPlayer沙盒安全限制,Unity网页游戏除了能读取浏览器缓存目录下的文件外,没有任何权限访问用户其他目录及文件

unity怎么打开网页 unity加载网页_操作系统_06

 

清除IE缓存命令:

rundll32.exe InetCpl.cpl,ClearMyTracksByProcess 8

 

开发调试技巧

在脚本中打印log到浏览器的console窗口中:

Application.ExternalCall( "BrowserLog", "my log message" );

然后在页面的Js脚本中增加函数:

<script type="text/javascript" language="javascript">
function BrowserLog( msg)
{
    // log the message
    try
    {
        if (console != null)
        {
            //控制台没有打开过时,该代码执行时会异常(注:控制台打开后又关闭则不会有问题),所以需要放在try-catch块中
            //否则会导致后面alert语句不会执行
            console.log(msg);
        }
    }
    catch (ex)
    {
        
    }

     alert(msg);
}
</script>

 

 

或者直接使用以下语句:

Application.ExternalCall( "console.log", "my log message" );

 

使用Development模式运行游戏:

1. 需要在html页面中不要禁止右键菜单

unity怎么打开网页 unity加载网页_javascript_07

2. 按住Alt键,在UnityWebPlayer插件上右键弹出如下快捷菜单(会多出一个Release Channel的菜单项)

unity怎么打开网页 unity加载网页_unity怎么打开网页_08

3. 会下载%homepath%\AppData\LocalLow\Unity\WebPlayer\player\Beta-4.63.x.x-Development版本的UnityWebPlayer来运行游戏

   输出的日志会包含堆栈信息

[2017-06-06 11:04:44 416]PublishLog:Device info: 
            DeviceId:d8c0a2227ec766787d43edbbba9fbd7a8d687a74
            deviceType:Desktop
            deviceModel:Intel(R) Core(TM) i7-4790 CPU @ 3.60GHz (16313 MB)
            deviceName:NICOCHEN-PC0
            operatingSystem:Windows 7 Service Pack 1 (6.1.7601) 64bit
            systemMemorySize:16313
            graphicsDeviceName:NVIDIA GeForce GTX 660  
            graphicsDeviceVersion:Direct3D 9.0c [nvd3dum.dll 9.18.13.3788]
            graphicsMemorySize:1989
            graphicsShaderLevel:30
            Screen Size:1440x900
            DPI:96
            ProcessorType: Intel(R) Core(TM) i7-4790 CPU @ 3.60GHz
            ProcessorCoreCount: 8

UnityEngine.Debug:Internal_Log(Int32, String, Object)
UnityEngine.Debug:Log(Object)
WNEngine.Logger:GeneralLog(ELogType, String, Object[])
WNEngine.Logger:PublishLog(String, Object[])
WNEngine.Logger:PrintIdentifyLog()
WNEngine.Logger:Init()
WNGameBase.GameFramework:Awake()
 
(Filename: C:/buildslave/unity/build/artifacts/WebPlayerGenerated/UnityEngineDebug.cpp Line: 56)

 

Attach调试游戏

1. 需要在html页面中打开调试开关

unity怎么打开网页 unity加载网页_操作系统_09

 

2. 打开游戏项目工程,“调试” -- “Attach Unity Debugger”

unity怎么打开网页 unity加载网页_ViewUI_10

 

UnityWebPlayer Security Sandbox(安全沙盒)

受UnityWebPlayer沙盒限制,在网页游戏逻辑里面访问web player级别不支持的方法或外部Native模块中方法,会抛出以下异常:

MethodAccessException: Attempt to access a private/protected method failed.

如果想在UntiyWebPlayer中使用Natvie模块中的功能,可通过间接绕行的方式来实现:

(1)写一个浏览器Plugin,在Plugin中调用Native模块

(2)在UntiyWebPlayer中通过ExternalCall调用js函数,在js函数中再调用Plugin中对应的函数,最终实现对Native模块的调用

 

参考

U3D-页游-检测机制-webplayer-调试方法