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

前言

页游目前有两个客户端入口：

网页端 (unity webplayer)
游戏微端 (unity standalone)

关于微端的技术，可参考我之前的文章：

dotNet开发游戏微端

游戏微端的多渠道思路和简易的自动化打包工具

总体思想

近日为提高页游的转化率，在做页游的检测机制，现把这个检测机制的思想及相关知识分享一下。大概就是浏览器-webplayer插件-操作系统-浏览器的一些信息检测和处理。

总体思想是，如果玩家不能通过网页启动游戏，根据操作系统区分，WIN7及以上优先安装微端，XP或其它操作系统建议下载webplayer插件

PS：关于webplayer 技术是否过时，官方是否不支持之类话题，此处不过多的讨论，如果是新的网页游戏项目建议使用webgl开发。

检测脚本：https://github.com/zhaoqingqing/blog_samplecode/blob/master/web-w3c/detect-for-webplayer.js

大致的原型检测流程图如下：

机制流程图

测试环境

windows 10 x64
- ie 11 ,edge ，firefox 48 , 360极速浏览器8.7-chrome50
- ie Test
windows 7 x64(SP1)
ie 11 ,firefox 48, chrome 52, 360极速浏览器8.7-chrome50
windows xp x86(官方原版)
ie 6 ,firefox 48, chrome 52

Unity Webplayer

Player Plugin Mono

网页播放器是由3个组件所构成的，分别是插件，播放器和Mono。播放器是执行你的游戏并为你加载资源的Unity运行时。它是和你制作Standalone游戏的时候所使用的运行时是一样的（或多或少）。

这个运行时需要Mono运行正确。（因为你的游戏使用的JavaScript、C#或者Boo脚本是需要依赖于Mono的）。

最后，这个插件是连接网页浏览器和运行时的中间件。该插件在Windows系统下对于IE浏览器下是ActiveX控件（OCX）的形式，对于其他类型的浏览器则是NPAPI-style动态连接库，而Mac下则是一个.plugin。

摘自：http://www.ceeger.com/Manual/TroubleShootingWebplayer.html

安装unity webplayer插件之后，在以下路径可以看到webplayer插件的一些文件

c:\Users\Administrator\AppData\LocalLow\Unity\WebPlayer\

loader(插件)

路径：Unity\WebPlayer\loader\

功能：Unity为浏览器提供的插件

UnityWebPluginAX.ocx
npUnity3D32.dll
UnityWebPlayerNP.map
info.plist

mono(运行时)

路径：Unity\WebPlayer\mono\Stable5.x.x\

功能：为mono提供运行时

Data\
mono-1-vc.dll
info.plist

Unity\WebPlayer\mono\Stable5.x.x\Data\lib\

System.Core.dll
System.dll
mscorlib.dll
Mono.Security.dll

player(播放器)

路径：Unity\WebPlayer\player\Stable5.x.x\

功能：网页播放器？真正的播放器，类似flash player?

Data\
wrap_oal.dll
webplayer_win.dll
info.plist

Unity\WebPlayer\player\Stable5.x.x\Data\

lib\
unity default resources

Unity\WebPlayer\player\Stable5.x.x\Data\lib\

UnityEngine.dll
CrossDomainPolicyParser.dll

CrossDomainPolicyParser(跨域政策解析器)

检测操作系统和浏览器

检测操作系统和浏览器信息

开源JS脚本：https://github.com/bestiejs/platform.js

使用方法：(建议在浏览器的控制台中运行)

检测操作系统
- platform.os.family(家族)： Windows XP,7,NT，版本：Server R2 10等
检测浏览器
- platform.name; platform.version，比如chrome 54,IE 11,Firefox 48 等

浏览器是否安装webplayer

对于chrome 52(不支持webplayer)，假如你的操作系统上安装了webplayer插件，那么可以检测出安装了webplayer，但如何检测是否可以运行呢？

方法一

IE内核使用ActiveX,其它内核使用插件检测,mimeType

资料：http://docs.unity3d.ru/Manual/Detecting the Unity Web Player using browser scripting.html

//just install in os , not detect support

function HasInstallWebPlayer() {

    var tInstalled = false;

    if (navigator.appVersion.indexOf("MSIE") != -1 &&

        navigator.appVersion.toLowerCase().indexOf("win") != -1) {

        tInstalled = detectUnityWebPlayerActiveX();

    } else if (navigator.mimeTypes && navigator.mimeTypes["application/vnd.unity"]) {

        if (navigator.mimeTypes["application/vnd.unity"].enabledPlugin &&

            navigator.plugins && navigator.plugins["Unity Player"]) {

            tInstalled = true;

        }

    }

    return tInstalled;

}

方法二

function GetUnity() {

        if (typeof unityObject != "undefined") {

            return unityObject.getObjectById("unityPlayer");

        }

        return null;

    }

WebPlayer是否运行成功

参考资料：http://www.ceeger.com/Manual/Working_with_UnityObject.html

通过unity提供的UnityObject.js来检测，UnityObject简化了Unity的内容嵌入到HTML中。它具有检测Unity网络播放器插件的功能，初始化网络播放器的安装和嵌入Unity的内容

注意事项

在WIN 10 + IE 11 安装了web player，但运行失败
360极速浏览器使用chrome50的内核，但依然可以运行webplayer(win 10 x64)

function UnityRunCallback(result) {

    var unityDiv = document.getElementById('unityPlayer');

    if (!result.success) {

        alert("webplayer 启动失败");

    }

    alert("webplayer 启动成功");

}

function RunUnity(){

    var width = document.documentElement.clientWidth;

    var height = document.documentElement.clientHeight;

    var params = {

        disableContextMenu: true,

        disableExternalCall: false,

        backgroundcolor: '000000',

        bordercolor: "000000",

        textcolor: "FFFFFF"

    }

    unityObject.embedUnity("unityPlayer", "WebPlayer.unity3d", width, height, params, null, UnityRunCallback);

 }

JS技术知识

string 转int
Number 或 parseInt(建议)
判断 object是否为null
typeof xxobj == "undefined"

JS全局函数，比window.onload 还更早执行,如下所示：

if (typeof unityObject != "undefined") {

    var width = document.documentElement.clientWidth;

    var height = document.documentElement.clientHeight;

    var params = {

        disableContextMenu: true,

        disableExternalCall: false,

    };

    unityObject.setBaseDownloadUrl("http://webplayer.unity3d.com/download_webplayer-3.x");

    //通过webplayer自启动，在callback中处理

    unityObject.embedUnity("unityPlayer", "WebPlayer.unity3d", width, height, params, null, unityLoaded);

}

webplayer调试

浏览器是否可运行webplayer

浏览器访问 http://unity3d.com/cn/webplayer/setup

如果当前使用的浏览器支可运行web player，则可以看到webplayer的版本号和缓存的文件信息，否则运行失败。

查看游戏的运行日志

On Windows 7 the debug log is located at C:\Users*Your User Name Here*\AppData\Local\Temp\UnityWebPlayer\log

webplayer调试模式

在浏览器中调试Unity web player的方法：按住 ALT键，然后点击右键 - Release Channel - Dev

调用浏览器的控制台打印日志

在unity的脚本中(C#)调用下列方法，可以将日志打印在浏览器的console

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

参考：http://stackoverflow.com/questions/25860597/unity-web-how-to-show-debug-log-in-browser-inspector-rather-then-library-lo

扩展资料

IE6倒计时

查看IE6在各国家的占用率

https://developer.microsoft.com/en-us/microsoft-edge/ie6countdown/

浏览器官网下载

Firefox 火狐

https://www.mozilla.org/zh-CN/firefox/new/

Chrome 离线版

https://support.google.com/chrome/answer/126299?hl=zh-Hans

https://www.google.com/chrome/browser/desktop/index.html?platform=win&extra=stablechannel&standalone=1

https://www.zhihu.com/question/19981495

====== 如安装遇到错误码：0x80004002 ，请自行科普

扩展阅读

unity3d webplayer UnityObject 你不知道的秘密

浏览器运行webplayer测试

下面以各个浏览器在安装webplayer插件之后，运行webplayer的测试，因操作系统环境，或浏览器是否官网版等原因，存在一定的局限性，欢迎各位指正。

微软

xp
- IE 6.7 运行失败
win 7
- IE 9,10,11 运行成功
win10
- IE 11 运行成功
- edge 不支持

firefox

firefox 全系列运行成功

PS: firefox 是否存在部分版本可以运行？

google

chrome45及以上运行失败，之前的版本则可以运行

chrome 45 移除了NPAPI

chrome地址栏输入 chrome://plugins/ 查看chrome启用的插件

PS:国产基于chrome内核的浏览器是否有做过修改？比如基于chrome 50但也可以运行webplayer成功，但google官方下载的chrome是运行失败的。