IE标签页小程序:基于跨浏览器的原生小程序系统-PluginOK(牛插)中间件( https://github.com/wangzuohuai/WebRunLocal )网络高级版开发,底层调用IE内核的ActiveX控件实现可程序化驱动的双内核浏览器。最低可用在Chrome 41、Firefox 50、Edge 80(Chromium内核)、360极速/安全、IE、Oprea 36、QQ等浏览器,也兼容运行于这些浏览器的最新版本。 1、PluginOK(牛插)中间件的安装: 1)、如果是exe的安装程序,请直接运行安装; 2)、如果是绿色版的程序包,请解压到磁盘某个目录后,双击“InstallWrl.bat”进行安装; 3)、安装完成时会启动PluginOK中间件服务,在安装目录下的Data子目录有ZbaService.txt日志文件输出运行情况。 2、IE标签页小程序控制相关接口: 说明:以下功能请通过Web Socket连接PluginOK主服务(ws://localhost:83?sid=12345&flag=1)后可执行,如默认侦听端口不是83(关于如何配置侦听端口,请参考SDK包中的文档“PluginOK开发者手册.doc”),请在连接地址中指定端口号进行连接。 HTTP网页在线测试:http://local.zorrosoft.com/ienewtab.html HTTPS网页在线测试:https://local.zorrosoft.com/ienewtab.html 如还需兼容IE浏览器使用,网络版测试网页中 的CLSID需要替换为:21ADE2E6-B4DD-4F3E-8BD5-9DDAD1785F3A 1)、请求启动IE标签页小程序: Type为浏览器类型,传0自动判断(前提是当前浏览器已启动并显示在最前端,Flag指定当前页加载时必须是0) 可强制指定浏览器类型Type(2代表Chrome 4代表Firefox 8代表Opera 16代表Edge(Chromium内核) 32代表360极速浏览器 33代表360安全浏览器 34代表360企业安全浏览器 50代表QQ浏览器 60代表搜狗浏览器) Flag掩码标记:1指定标签页加载(1和16都不指定时为当前页加载) 2小程序显示窗口边框 Title:标签页页时为创建的网页标题 Version 指定加载的IE版本,0不指定,比如9999是IE9标准模式 8888是IE8标准模式 8000是IE8兼容模式 7000是IE7 详细定义参考:https://docs.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-developer/general-info/ee330730(v=vs.85)?redirectedfrom=MSDN#browser_emulation X64:是否启动64位版 Open为需要用IE内核打开的Url实际地址或本地网页地址; 注意:Open和Url如果有特殊字符= & 双引号或中文等,需要用URL编码处理后传递 举例: 自动识别当前浏览器启动: {"req":"Wrl_IETab","rid":6,"para":{"Type":"0","Flag":0,"Title":"IE Tab","Version":"0","X64":"0","Open":"http://xiuxiu.web.meitu.com/main.html"}} 浏览器当前页面启动演示 http://local.zorrosoft.com/IENewTab.html 启动后会先后收到三个JSON数据包 A、{"ret":0,"rid":1,"data":{"ID":1}} 代表小程序WS侦听服务就绪 B、{"event":"Wrl_Listen","aid":1,"data":{"SID":"123","PID":"IENewTab","port":980}} 返回的侦听端口,可再建立一个Web Socket连接后,调用小程序中的相关功能,比如新打开一个网页。 返回ID为当前小程序运行ID,通过此ID,可执行Wrl_AppletControl命令。 C、{"event":"Wrl_AppletOK","aid":1,"rid":6,"data":{"SID":"123","PID":"IENewTab","Port":980}} 2)、请求控制IE标签页小程序: 当前端不再需要小程序时可指定关闭,或者显示/隐藏及全屏显示等 ID为Wrl_IETab启动小程序时返回的ID值,Code代表控制类型掩码:1关闭 2全屏显示 4自动隐藏 8还原显示。其中全屏显示2,可直接通过热键ESC或取消,4隐藏后可通过8恢复显示 {"req":"Wrl_AppletControl","rid":2,"para":{"ID":"1","Code":4}} 3、小程序安装、升级、卸载 1)、请求安装IE标签页小程序 请在测试网页输入框中,输入如下请求,然后点击发送,完成安装: {"req":"Plugin_Install","rid":1,"para":{"Name":"IE标签页小程序","PID":"IENewTab","Date":"2021-10-25","Desc":"PluginOK之上跨浏览器的IE标签页内嵌小程序,支持在Chrome、Edge、Firefox、IE、Oprea、360、QQ等最新版本浏览器网页中内嵌使用","DownAddr":"http://local.zorrosoft.com/Files/Net/IENewTab.pid","MD5":"54531881295DD5E749B1E690F7496023","Version":"2.2.3.2","Size":688128,"HideIns":0,"Type":8,"Cookie":"","Auth":"","TK":"4659D10B401DAF8FAD9D20B87F1610F8C8FCE8031D75B48B8EADC40DA88703C79C01197CC1C343DCD827CA64C9D15CD264F93A7C7F0EC6C30EA5CB2DEC03927471F46FBAEE5EA6EE3222CEB5D3E310C85C77D37E518BDAAD270261D09E721BB2B019AC9D015B29C9801E3EFDA6AFE63E4F0331C3D297F26017CFEA96A776CADB1A16D57E7A9F60555C3F01A1F640863D13CD4E38510CA122839F40BCA5D373E057462731557B5F5D7418D89D121CA8353E0A76F80871CBE882854972F7ECC88F95A0951EACE43A91B4FBE289776D82BF5E2FB688F140D56783B00FA9844CC289486DC3B5326FC8364F27E9C50C0BC3CEE1D32028FCD0BA157C6F8CD0471E1678"}} 启动安装后,会不断收到安装进度直到安装结束。 2)、请求升级IE标签页小程序: {"req":"Plugin_Update","rid":1,"para":{"Name":"IE标签页小程序","PID":"IENewTab","Date":"2021-10-25","Desc":"PluginOK之上跨浏览器的IE标签页内嵌小程序,支持在Chrome、Edge、Firefox、IE、Oprea、360、QQ等最新版本浏览器网页中内嵌使用","DownAddr":"http://local.zorrosoft.com/Files/Net/IENewTab_Update.pid","MD5":"1AD7DBF00BFF24444E86A2CD544B6D70","Version":"2.2.3.2","Size":688128,"HideIns":0,"Type":8,"Cookie":"","Auth":"","TK":"00B6699DF08AA394ACCF93DA042F0462FB35832E0A144926EAB03E0BFA7B25D8DF25A942900AAA9B3A248A403265A149047E67FA0266C1094C83E20E94B5CC028CE6BC1B740F6750EB19CB1976AD8B065BD98BDF65FCCFA7D3A60215001BE1FD8C352995FB0F9B12750B577BFE686E430658824BC4DBA341602B168D4BCCAA78818DF8021B4B6FB596D896F7549F3637F834C23B4B085BED4F090E5F6979B8E703FF80871C421ADC995515936AC6D955D7B15F70B918BF82424675929E779A3FB152E38E4A81CAF620E1908B939B4A5AC7BD5DA5669BDA15D2508DB2C9DD59104CD6D2600E49101AA3978BB82353966002B5758976F347F426A344D5FCE4B6FA"}} 以上安装和升级的JSON请求包,可能因版本升级导致内容不同,如遇安装或升级时报错,请联系客服获取最新的请求包。 3)、请求卸载IE标签页小程序: 正式版需要添加TK校验,具体规则请参考SDK包中文档“PluginOK中间件安全解决方案.doc”,可在SDK包中的打包程序ZbaPackage.exe的中间件维护生成带TK的请求。 {"req":"Plugin_Remove","rid":3,"para":{"PID":"IENewTab","Type":8}} 4、IE标签页小程序转调用ActiveX接口,先根据Wrl_IETab请求启动后返回的端口号,新建立一个WebSocket连接后可执行如下指令: A、常用功能请求: 1) 停止 请求:{"req":"IE_Stop","rid":50,"para":{}} 返回:{"ret":0,"rid":50,"data":{"Ret":"0"}} ret为请求返回值,0正常,非零不正常,不正常时请取和ret同级的错误描述err,下同 Ret为调用ActiveX对应函数返回值,0代表正常 2) 刷新网页 请求:{"req":"IE_Refresh","rid":51,"para":{"Loop":"1"}} 返回:{"ret":0,"rid":51,"data":{"Ret":"0"}} Ret为调用ActiveX对应函数返回值,0代表正常 3) 回退 请求:{"req":"IE_GoBack","rid":52,"para":{}} 返回:{"ret":0,"rid":52,"data":{"Ret":"0"}} Ret为调用ActiveX对应函数返回值,0代表正常 4) 前进 请求:{"req":"IE_GoForward","rid":53,"para":{}} 返回:{"ret":0,"rid":53,"data":{"Ret":"0"}} Ret为调用ActiveX对应函数返回值,0代表正常 5) 导航到主页 请求:{"req":"IE_GoHome","rid":54,"para":{}} 返回:{"ret":0,"rid":54,"data":{"Ret":"0"}} Ret为调用ActiveX对应函数返回值,0代表正常 6) 导航到指定网页 Url为网页地址,需进行URLCode编码,如额外指定Type为0或具体的浏览器类型,代表用非IE浏览器新标签页来打开 请求:{"req":"IE_Navigate","rid":55,"para":{"Url":"http://www.baidu.com"}} 返回:{"ret":0,"rid":55,"data":{"Ret":"0"}} Ret为调用ActiveX对应函数返回值,0代表正常 7) 请求执行脚本,必须等文档加载完成后 Code为需要执行的脚本内容 Language 脚本类型 请求:{"req":"IE_ExecScript","rid":56,"para":{"Code":"alert(\"hello\");","Language":"javascript"}} 返回:{"ret":0,"rid":56,"data":{"Ret":"0","ScriptRet":""}} Ret为调用返回值,0代表正常 ScriptRet执行脚本返回内容,只支持字符型,非字符型先用BASE64编码 8) 请求注入脚本,必须等文档加载完成后 Code为需要注入的脚本内容 请求:{"req":"IE_AddScript","rid":57,"para":{"Code":"alert(\"hello\");"}} 返回:{"ret":0,"rid":57,"data":{"Ret":"0"}} Ret为调用返回值,0代表正常 9) 请求调用脚本(已在打开的网页中),必须等文档加载完成后 FuncName脚本函数名称 Para函数参数 请求:{"req":"IE_InvokeScript","rid":58,"para":{"FuncName":"HelloWord","Para":["My","Name"]}} 返回:{"ret":0,"rid":58,"data":{"Ret":"0","FuncRet":""}} Ret为调用返回值,0代表正常 FuncRet调用函数返回内容,只支持字符型,非字符型先用BASE64编码 10) 请求退出小程序 未连接到小程序侦听WS端口时直接关闭到中间件的WS连接即可 请求:{"req":"IE_Exit","rid":59,"para":{}} 无返回 5、事件通知: A、IE控件事件 1) IE_BeforeNavigate 准备打开新的URL {"event":"IE_BeforeNavigate","data":{"Url":""}} Url为新打开的URL地址 2) IE_NavigateComplete URL打开完成 {"event":"IE_NavigateComplete","data":{"Url":""}} Url为URL地址 3) IE_DocumentComplete URL文档加载完成 {"event":"IE_DocumentComplete","data":{"Url":""}} Url为URL地址 4) IE_NewNavigate 新窗口打开指定URL {"event":"IE_NewNavigate","data":{"Url":"","Ret":0}} Url为新URL地址 Ret为打开结果 5) IE_ProgressChange 进度条进度通知 {"event":"IE_ProgressChange","data":{"Progress":0,"Max":0}} Progress当前进度 Max进度最大值 6) IE_SetSecureLockIcon 设置安全锁定图标 {"event":"IE_SetSecureLockIcon","data":{"SecureLockIcon":0}} 7) IE_StatusTextChange 状态变化 {"event":"IE_StatusTextChange","data":{"Status":""}} Status状态文字描述 8) IE_TitleChange 标题变化 {"event":"IE_TitleChange","data":{"Title":""}} Title 标题 9) IE_WindowClosing 窗口关闭 {"event":"IE_WindowClosing","data":{"ChildWindow":0}} ChildWindow是否子窗口 10) IE_CommandStateChange 命令状态变化 {"event":"IE_CommandStateChange","data":{"Command":0,"Enable":0}} Command命令ID,Enable是否启用 B、PluginOK支持的事件通知: 1) IE_FullScreen 小程序是否响应了热键全屏 {"event":"IE_FullScreen","data":{"FullScreen":0}} FullScreen为当前是否全屏标记 2) Wrl_AppletExit 小程序退出通知 {"event":"Wrl_AppletExit","data":{"ID":1}} 6、其它 请求参数的JSON数据包,请确保是UTF-8无签名的编码。 更多接口请求说明,请参考安装目录中的文档TestWrl.txt、SDK包中的“PluginOK开发者手册.doc”及“PluginOK中间件安全解决方案”。 如还有疑问请直接联系客服 加微信:ZorroSoft,或加QQ群:23126938