TestWrl.txt 19.7 KB
Newer Older
W
wangzuohuai 已提交
1
PluginOK(牛插)中间件网络标准版-跨浏览器的原生小程序系统功能测试:
W
wangzuohuai 已提交
2

W
wangzuohuai 已提交
3
1、请下载中间件网络版安装包(http://local.zorrosoft.com/Files/PluginOK.zip)后执行安装,安装时需要管理员权限运行,安装完成时会启动PluginOK中间件服务,在安装目录下的Data子目录有ZbaService.txt日志文件输出运行情况;
W
wangzuohuai 已提交
4

W
wangzuohuai 已提交
5
2、启动Chrome等浏览器并打开网页 http://local.zorrosoft.com 进行测试(HTTPS网站测试请打开 https://local.zorrosoft.com ,HTTPS网站请把连接的通讯协议 ws: 改为 wss: 再执行),如在IE等浏览器中测试,如提示启用佐罗软件的WebSocket连接ActiveX控件,请选择“是”;
W
wangzuohuai 已提交
6

W
wangzuohuai 已提交
7
3、测试连接PluginOK(牛插)系统服务,下面是参数说明:
W
wangzuohuai 已提交
8
sid是唯一连接会话标识(小程序服务支持同时多个连接,需要用唯一标识进行区分)
W
wangzuohuai 已提交
9
pid是连接小程序的唯一标识(在小程序配置文件PluginConfig.json中定义的PID值),不传时表示连接主服务
W
wangzuohuai 已提交
10
flag是连接控制掩码,1指定输出调试日志,2指示通讯数据进行GZip压缩(网页JS需要进行同步处理),3代表1+2,4用管理员权限启动(仅限于启动弹窗或内嵌网页小程序)。
Z
zorrosoft 已提交
11
请求连接PluginOK(牛插)主服务:ws://127.0.0.1:83?sid=123&flag=1 点击连接按钮会输出连接结果,在HTTP网页中,127.0.0.1可替换为localhost或wrl.zorrosoft.com(HTTPS网站需要)进行连接,如果您的电脑83端口已经被占用,服务侦听端口会自动切换为84,那么连接地址请修改为:ws://127.0.0.1:84?sid=123&flag=1;
W
wangzuohuai 已提交
12

W
wangzuohuai 已提交
13
连接PluginOK(牛插)主服务后支持的功能协议:
W
wangzuohuai 已提交
14

W
wangzuohuai 已提交
15
1)、获取或对比版本信息
W
wangzuohuai 已提交
16
Mac为1时获取本机Mac地址信息,More取更多信息(当前登录用户、键盘和鼠标空闲时间、当前电脑制造商及型号等),IP为1时获取当前网络路由器IP地址和本机IP地址,Router获取当前网络路由器MAC地址的超时时间(0代表不获取,30代表3秒超时),Config为1时获取中间件的一些配置参数。
W
wangzuohuai 已提交
17 18
说明:连接主服务后可执行,返回当前软件版本、当前系统版本、唯一标识、授权有效期、授权客户名称、当前系统启动后运行时间、程序运行路径等;
获取版本信息举例:
W
wangzuohuai 已提交
19
{"req":"Wrl_Version","rid":1,"para":{"Mac" : 1,"More" : 0,"Config" : 1,"Router" : 0,"IP" : 1}}
W
wangzuohuai 已提交
20
协议中的rid代表此请求序号(长整型),请求返回的结果json中也会带这个参数,因为ws请求和返回是异步执行的,这样可以确保请求和结果的一一对应关系,下同
Z
zorrosoft 已提交
21
返回:{"ret":0,"rid":1,"req":"Wrl_Version","data":{"Version":"2.2.9.1","ValidDay":"2022-12-31","AuthName":"成都佐罗软件","Type":8,"OS":"10.0.18363.2","Win64":1,"UniID":"C69C5505AD73EFDD7A6BA38D83665889","Time":8103544,"TickCount":17184796,"Adv":1,"RunPath":"D:/Zorro/WRL/","Mac":[{"Card":"802.11n USB Wireless LAN Card","Mac":"38:B84:9E:2F:38:6A"}],"Router":["90:6F:AB:8F:BB:58"],"Config":{"NoService":0,"Localhost":1,"Delay":1,"Monitor":60,"Mac":1,"UDisk":0,"Lang":"CHS"}}}
W
wangzuohuai 已提交
22 23 24 25 26 27 28 29 30 31 32 33 34

对比是否有新版本举例:
{"req":"Wrl_Version","rid":1,"para":{"Version" : "1.0.1.1"}}  给定新版本号,判断当前中间件版本是否需要升级,返回节点字段Update为1时需要升级,0不需要升级
{"req":"Wrl_Version","rid":1,"para":{"PID" : "F90B1CF0-8485-40ec-B4E8-B87598AAB35D","Version" : "1.0.1.1"}}  指定PID的小程序新版本号,判断小程序是否需要升级,返回节点字段Update为1时需要升级,0不需要升级,2代表小程序还未安装

2)、指定浏览器打开指定Url:
分别指定浏览器类型Type(1代表IE 2代表Chrome 4代表Firefox 8代表Opera 16代表Edge(Chromium内核) 32代表360急速浏览器 33代表360安全浏览器 34代表360企业安全浏览器 50代表QQ浏览器 60代表搜狗浏览器)和Url地址;
Flag意义:0代表标签页打开,1代表新窗口打开(360等不支持);
Show显示窗口类型,默认1正常显示,2最小化显示 3最大化显示。
此功能主要用于强制IE打开指定网页;
举例1:
强制用IE9兼容模式内核浏览器打开 http://www.zorrosoft.com 
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
W
wangzuohuai 已提交
35
{"req":"Wrl_OpenUrl","rid":2,"para":{"Type":"1","Url": "http://www.zorrosoft.com","Flag":"1","Version":"9000"}}
W
wangzuohuai 已提交
36 37
举例2:
Chrome浏览器新窗口打开http://www.zorrosoft.com Flag为1新窗口打开,否则是新标签打开
W
wangzuohuai 已提交
38
{"req":"Wrl_OpenUrl","rid":3,"para":{"Type":"2","Url": "http://www.zorrosoft.com","Flag":"0"}}
W
wangzuohuai 已提交
39
举例3,请求FireFox浏览器打开指定URL:
W
wangzuohuai 已提交
40
{"req":"Wrl_OpenUrl","rid":5,"para":{"Type":"4","Url": "http://www.zorrosoft.com"}}
W
wangzuohuai 已提交
41
举例4,请求360极速浏览器打开指定URL:
W
wangzuohuai 已提交
42
{"req":"Wrl_OpenUrl","rid":6,"para":{"Type":"32","Url": "http://www.zorrosoft.com"}}
W
wangzuohuai 已提交
43
举例5,请求360安全浏览器打开指定URL:
W
wangzuohuai 已提交
44
{"req":"Wrl_OpenUrl","rid":7,"para":{"Type":"33","Url": "http://www.zorrosoft.com"}}
W
wangzuohuai 已提交
45
举例6,请求Edge新内核浏览器打开指定URL:
W
wangzuohuai 已提交
46 47
{"req":"Wrl_OpenUrl","rid":8,"para":{"Type":"16","Url": "http://www.zorrosoft.com"}}

W
wangzuohuai 已提交
48
3)、请求使用关联程序打开指定文件:
49
指定本地文件全路径,使用本地电脑默认关联的程序打开,路径用反斜杠或双斜杠。如是中文等路径,需要先进行UrlEncode编码。
W
wangzuohuai 已提交
50
为安全起见,这些扩展名文件不支持:*.exe *.msi *.js *.jar *.inf *.com *.bat *.vbs *.py,如实在需要支持这些文件的启动,请购买单独发现的文件操作小程序授权,具体请联系客服。
W
wangzuohuai 已提交
51
举例:
52
{"req":"Wrl_OpenFile","rid":9,"para":{"File" : "F:/Zorro/Ver/TestWrl.txt"}}
W
wangzuohuai 已提交
53 54 55 56 57 58 59 60 61 62 63 64 65
说明:连接主服务后可执行;

4)、单选(多选)磁盘文件/设置文件保存位置:
可指定选择文件对话框标题、筛选文件类型、最大可选文件数量、初始化路径等参数。
Type 操作方式 0代表选择文件 1代表设置文件保存路径
Single 是否单选 选择文件时有效
Ext 文件类型,默认为 图像文件(*.jpg;*.gif;*.bmp;*.png;*.tif)\r*.jpg;*.gif;*.bmp;*.png;*.tif;*.jpeg\r所有文件(*.*)\r*.*
Title 对话框标题,默认为 请选择文件
Name 文件保存默认名称 选择文件时无效
BtnText 按钮文字 设置文件保存位置时无效
Path 初始化显示路径,默认为 当前用户文档目录
举例:
选择文件
66
{"req":"Wrl_SelectFile","rid":10,"para":{"Type" : 0,"Single" : 1,"Title" : "单选文件","BtnText" : "确定(&O)","Ext" : "所有文件(*.*)\r*.*","Path" : "D:/Zorro/"}}
W
wangzuohuai 已提交
67
设置文件保存位置
68
{"req":"Wrl_SelectFile","rid":11,"para":{"Type" : 1,"Title" : "请选择文件保存位置","Ext" : "文本文件(*.txt)\r*.txt","Path" : "D:/Zorro/","Name" : "测试"}}
W
wangzuohuai 已提交
69 70 71 72 73 74 75 76 77 78 79
说明:连接主服务后可执行,由于此请求有对话框阻塞行为,执行后的结果通过事件推送方式返回,定义如下:
{"event":"Wrl_SelectFile","rid":12,"data":[{"File":"E:/WRL/测试.txt"}]}
取消时推送:{"event":"Wrl_SelectFile","rid":12,"err":"被取消"}

5)、选择目录:
可指定对话框标题等参数。
Title 对话框标题,默认为 请选择文件
BtnText 按钮文字 设置文件保存位置时无效
举例:
{"req":"Wrl_SelectFolder","rid":13,"para":{"Title" : "选择本地目录","BtnText" : "确定(&O)"}}
说明:连接主服务后可执行,由于此请求有对话框阻塞行为,执行后的结果通过事件推送方式返回,定义如下:
W
wangzuohuai 已提交
80
{"event":"Wrl_SelectFolder","rid":13,"data":[{"Folder":"E:/WRL/"}]}
W
wangzuohuai 已提交
81
取消时推送:{"event":"Wrl_SelectFolder","rid":6,"err":"被取消"}
W
wangzuohuai 已提交
82

W
wangzuohuai 已提交
83 84 85
6)、请求获取指定文件大小、版本、文件属性、MD5、创建时间、修改时间等信息:
指定本地文件全路径,路径用反斜杠或双斜杠,如果是图片文件,还会返回高度和宽度信息。
举例:
86
{"req":"Wrl_GetFileInfo","rid":14,"para":{"File" : "D:/Zorro/test.png"}}
W
wangzuohuai 已提交
87
说明:连接主服务后可执行;
W
wangzuohuai 已提交
88

W
wangzuohuai 已提交
89
7)、请求重新注册中间件或小程序:
W
wangzuohuai 已提交
90
如指定PID代表重新注册指定的小程序,否则执行重新执行中间件安装批处理(连接会断开),可能因为一些工具或手工误删除了注册表等,用于修复本中间件使用配置。如用于重新配置中间件正式版需要添加TK校验,具体规则请参考SDK包中文档“PluginOK中间件安全解决方案.pdf”,可在SDK包中的打包程序ZbaPackage.exe的中间件维护生成带TK的请求。
91 92 93
注册小程序,举例:
{"req":"Wrl_RegCom","rid":15,"para":{"PID" : "A22E18F1-95F8-4FDB-99D2-188E5FB12B23"}}
指定一些参数重新注册中间件,相当于重新安装中间件
W
wangzuohuai 已提交
94 95
NoService为1代表以非系统服务方式重新安装中间件 Localhost为0代表用本机实际IP来侦听,方便局域网其他电脑访问
{"req":"Wrl_RegCom","rid":15,"para":{"NoService" : "1","Localhost" : "0"}} 
W
wangzuohuai 已提交
96
说明:连接主服务后可执行;
W
wangzuohuai 已提交
97

W
wangzuohuai 已提交
98 99
8)、请求当前浏览器类型和版本等信息:
举例:
W
wangzuohuai 已提交
100
{"req":"Wrl_BrowserInfo","rid":16,"para":{}}
W
wangzuohuai 已提交
101 102 103
说明:连接主服务后可执行;
返回:{"ret":0,"rid":16,"data":{"Type":2,"PID":6324,"Ver":"83.0.4103.61"}}
Type为浏览器类型 PID为当前进程ID Ver为版本
W
wangzuohuai 已提交
104

W
wangzuohuai 已提交
105 106 107
9)、列出当前已授权的小程序列表:
举例:{"req":"Plugin_Authed","rid":17,"para":{}}
说明:连接主服务后可执行,可获取当前已授权所有小程序列表;
W
wangzuohuai 已提交
108

W
wangzuohuai 已提交
109 110 111
10)、列出已安装所有小程序:
举例:{"req":"Plugin_List","rid":18,"para":{"Detail" : 0}}
说明:连接主服务后可执行,可获取当前已安装所有小程序信息,Detail为1时返回小程序程序全路径;
W
wangzuohuai 已提交
112

W
wangzuohuai 已提交
113
11)、判断某个小程序是否已存在
114
举例:{"req":"Plugin_Exist","rid":19,"para":{"PID" : "A22E18F1-95F8-4FDB-99D2-188E5FB12B23"}}
W
wangzuohuai 已提交
115
说明:连接主服务后可执行,PID为小程序唯一标识;
W
wangzuohuai 已提交
116

W
wangzuohuai 已提交
117 118
12)、请求重新加载指定小程序
使用场景:不用重启服务即可扫描新增小程序使用;或小程序调试时,程序及配置更新需要重新加载时
119
举例:{"req":"Plugin_Refresh","rid":20,"para":{"PID" : "A22E18F1-95F8-4FDB-99D2-188E5FB12B23"}}
W
wangzuohuai 已提交
120
说明:连接主服务后可执行,PID为小程序唯一标识;
W
wangzuohuai 已提交
121

122 123 124
13)、前端请求配置参数
UDisk是否监控U盘动态
Adjust矫正参数,个别电脑小程序运行时位置错误,需要单独配置
W
wangzuohuai 已提交
125
Monitor配置服务无响应超时时间,一旦超过服务会自动重启
126 127 128
以上参数可同时配置,也可以只配置一个参数
举例:{"req":"Wrl_Config","rid":21,"para":{"Monitor" : 30,"Adjust" : 0,"UDisk" : 1}}
说明:连接中间件主服务后可执行;
W
wangzuohuai 已提交
129

W
wangzuohuai 已提交
130 131
14)、前端请求启动中间件,网页中点击以下链接,可启动中间件主程序。
<a href="BrowserApplet://DeskRun">点击这里启动PluginOK网络版</a>
W
wangzuohuai 已提交
132

W
wangzuohuai 已提交
133 134
15)、安装范例小程序
请在输入框中,分别输入如下请求,然后点击发送,完成四个范例小程序的安装:
W
wangzuohuai 已提交
135

Z
zorrosoft 已提交
136
{"req":"Plugin_Install","rid":1,"para":{"Name":"DLL小程序范例(C++语言)","PID":"A22E18F1-95F8-4FDB-99D2-188E5FB12B23","Date":"2023-02-08","Desc":"无窗小程序(C++语言)-读写TXT记事本及获取当前系统信息","DownAddr":"http://local.zorrosoft.com/Files/Net/PluginComDll.pid","MD5":"48FCF345D63FFE92A3F8C151A25C8D4D","Version":"2.2.9.1","Size":557056,"HideIns":0,"Type":1,"Cookie":"","Auth":"","TK":"67C0B1D7A08DFEA0315DB35075DA3F19F5259387E204223057C79892DE5ADB6728359DE633674DB35B6B71779F8418E8A6679664C95FF4422E59BFB9095BAE711EB1EF88B6D1884962E15F48927F45AB1D5498DFC8EE64C6E4039A3160BAEAA2E34675D21D630EB6E9FA84743ECA57DAC5F5F6CA14348C9E0FE15865984E98ADD095AD3EEFAB5DC1B4C45D025595009BE2E05BF4C440427EB3CA97EE3E4E5A25D98998302EBA7A910902F4960CF7F477B252E16D9B62EEED7B3D717EE67304A0FB81775FB4DBDD0AB6CA6091DDF261C1CE0418B3322D8D648A95A799C6299A408905E5C02EFCEC317D52DF8B7875A429EB14D66EE6932E2E5AA80D0902EBEBCA"}}
W
wangzuohuai 已提交
137

Z
zorrosoft 已提交
138
{"req":"Plugin_Install","rid":1,"para":{"Name":"弹窗小程序范例(C++语言)","PID":"PluginWinExe","Date":"2023-02-08","Desc":"弹窗小程序(C++语言)-演示脚本请求打开指定网站","DownAddr":"http://local.zorrosoft.com/Files/Net/PluginWinExe.pid","MD5":"73807E938617654826266A61A5CA1183","Version":"2.2.9.1","Size":655360,"HideIns":0,"Type":2,"Cookie":"","Auth":"","TK":"2E947779A60DA54F2F7BD623D0202B85F4B186DF31BAFE0EDBED85F4ADA5111ED293E5D5F197BF04E6969E2290D7C6CBDDBB6DFD9546FAED2CB71A71B50C14C38CFF56D75800B723494104DB4CBB7577019C97C0A656A6FE937636037501E541DA62D86C2DF316FA3EE3230227C2737BDA00A720D80791E6E8E6A57CB3F5588A0F39EFE5CE6B15C3D522B6C7DDE1E639D13A18C456732BB1A890EA585607DAC5D122903A57B1F68957B955935807D6C06EEF1B1240ABE3F9F7FB9ED33DB5344144086CB44C7279723D3DF8451B9E1F6C1B08773243F2AF04D57995F079724D7B43BE56C79C5CD7404D8D1FFD684A3A77157DB9917DBB27F973E7DA600E28D719"}}
W
wangzuohuai 已提交
139

Z
zorrosoft 已提交
140
{"req":"Plugin_Install","rid":1,"para":{"Name":"DLL小程序范例(C#语言)","PID":"D10495F4-DF0F-44FA-8647-91275347214A","Date":"2023-02-08","Desc":"无窗口小程序范例(C#语言)","DownAddr":"http://local.zorrosoft.com/Files/Net/PluginNetDll.pid","MD5":"3A118C99ADE5FA5A66C480A6E4C3537C","Version":"2.2.9.1","Size":458752,"HideIns":0,"Type":1,"Cookie":"","Auth":"","TK":"4276339653A08F4C85C888D6623F4D123326DC8C6560D0C18F84894190AD1E1A2CD31ECDA3D20B60AC8A53F8CEFB85DF15FD67809C062B3FDF4FF6896E7AF7513177D7B05847BAD700F3F9597FF0D7DEF017F07CB22195047646C5CE1AD95FCA4EF877B45973A5A1CCEC37B223BA6BE4A18C97DBFF788CD8C035C9AFE678A718F6EAA3DA31564C2EBA00EA25A128D8F9682E179834F48AE77584D349BF8D6306A17889810E0D783B9A2BD09B39D769DB0587F6B0FA72B5CE30A4CF8B621B2229C7B84DCF034CEBDA087C9112F7282994473B4786294996754803759F360C8BF8CE8EB37E7B027324A70A7FCFC4B8CC065A3646989BF155C8C7666989309D22C4"}}
W
wangzuohuai 已提交
141

Z
zorrosoft 已提交
142
{"req":"Plugin_Install","rid":1,"para":{"Name":"弹窗小程序范例(C#语言)","PID":"PluginExeDemo","Date":"2023-02-08","Desc":"弹窗小程序范例(C#语言)-演示脚本请求打开指定网站","DownAddr":"http://local.zorrosoft.com/Files/Net/PluginExeDemo.pid","MD5":"9EEEE6DDC19D5EE347B1FF0DB97C0205","Version":"2.2.9.1","Size":655360,"HideIns":0,"Type":2,"Cookie":"","Auth":"","TK":"62A5A183560CFD3AF48778B6ECF96420E2A44495F29B61D9D41EB64FFD9DC1D410FC3DA08FFC37A18AA94621427357F8DCF7CA984D63452B4B0FFF185C5D182B6C5298D49F7D03CF5586DE2D8367F2DAD993792EFAFF661A11AEADE0898BACC7C57474B63631D29017AA8D456F88AE239C564DD1CBB8B80BF3FAC637ABBC1D99766D01366F1D95B7060561BE45BC28F3B73561E8B89286D631C1A92DDD70215ACBCB05C6E7EB0A9B04E00518E45BE860084280A2CACB92835DF0158D3CB0CDB6AD0B7B7EE6A9F3F98332427B64523DD59A27AE59CF49DA9D2B6A38834648498FA7E452F11C362B304C66772C7AE3E87E1AC5CA49D7A6915605DC4621BE1392CF"}}
W
wangzuohuai 已提交
143

W
wangzuohuai 已提交
144
16)、范例小程序升级请求:
W
wangzuohuai 已提交
145

Z
zorrosoft 已提交
146
{"req":"Plugin_Update","rid":1,"para":{"Name":"DLL小程序范例(C++语言)","PID":"A22E18F1-95F8-4FDB-99D2-188E5FB12B23","Date":"2023-02-08","Desc":"无窗小程序(C++语言)-读写TXT记事本及获取当前系统信息","DownAddr":"http://local.zorrosoft.com/Files/Net/PluginComDll_Update.pid","MD5":"2129FCE2D89821331780C1A710210565","Version":"2.2.9.1","Size":557056,"HideIns":0,"Type":1,"Cookie":"","Auth":"","TK":"1C4EAAD86FEB1FB7F089C5889EF8EF3C39998F2749522C1D1305FBF7511E38299DB7F231C1262FCF4639C1C26450249266E7BEC943006C1D97F8CE09CCF551D3C1C1E1F76EEA00DEB0E8E776E8D563EE72D780DAEAFFB10195E0CBEE8A9A9BB806557F7083C481EBCA242E773040057732AF259591D42326898C5BBB7FB9FD7701F2CE16612789916D30BEA2E2C8DE96114A5AF90EACC76F1075E0C1E7E3CAC045E6E5265A46E98918264B6D86D052E3A9A7A9B334ADE42DF71640CCE5536FB2AFC294B5A47E44F88FDE0156204E13DD9CC2FE4B4FD6F7C2AA59A1D5878A80ACDD8FD8FE92DB49C63D4F132BD597B511819D8DD24E0FF06E94E1E097E8800EE7"}}
W
wangzuohuai 已提交
147

Z
zorrosoft 已提交
148
{"req":"Plugin_Update","rid":1,"para":{"Name":"弹窗小程序范例(C++语言)","PID":"PluginWinExe","Date":"2023-02-08","Desc":"弹窗小程序(C++语言)-演示脚本请求打开指定网站","DownAddr":"http://local.zorrosoft.com/Files/Net/PluginWinExe_Update.pid","MD5":"814BB665F8E4A35EE4A0D3D10A76A741","Version":"2.2.9.1","Size":655360,"HideIns":0,"Type":2,"Cookie":"","Auth":"","TK":"04B6DD9216E903FC416AC10B611389B943798F15EACA48C2E47F1BC71E6402B67DB50AA475A8914BFC9231734DB1816FE65B55C9EADE1A4547222B2B8645B1B36A9694968BFDDC1AAC3CB6774F18FCC3230D8A0EA2317F33B6CDFF62A6B4FCF5BF9E8B357E65B192D9D281D8FCFCFDB6145DDFEB3CA07D3AC8A6C7C31A22AA8AB8F6D913F9A3ABF51B101225CA99EB7963BE9AE1CF3257E7EFFCF6D86FBB641FC4EE1A2BDAA7013A17CB0C7AA945B074307BB1D0F2E79922D8D88CD5D901819580FECD153D81D4D28A997B6866489CF044610C65A8F42BFBED9E813515CF25A4A0982EEF759AF6CB4FD58618400168734D5E6E9886556CA92255F4C6B117E3B2"}}
W
wangzuohuai 已提交
149

Z
zorrosoft 已提交
150
{"req":"Plugin_Update","rid":1,"para":{"Name":"DLL小程序范例(C#语言)","PID":"D10495F4-DF0F-44FA-8647-91275347214A","Date":"2023-02-08","Desc":"无窗口小程序范例(C#语言)","DownAddr":"http://local.zorrosoft.com/Files/Net/PluginNetDll_Update.pid","MD5":"485A42B66D5B5A3D6900999DB7A9F08F","Version":"2.2.9.1","Size":458752,"HideIns":0,"Type":1,"Cookie":"","Auth":"","TK":"3435ACE5DC47F55F894115FDE6D44F189CC4AC78EF5AC5395BF12AF99E8087EA239C23589B723634BDF2856B31FC78CE2F7D077AA79B91D3C22D5A1C66F8B72167B685BF3422A83E29B3DCB00DBBC57A37D747452FA342658A32124FE0D07F2A83F26133479836845BA4B027E24681A30A4FF94E1F9C1AECE28A1BCDF229416AAD43928F318945558D1F2019A322EA9A3D6A96889B824AE78F57060310219B1891B2BB55EE7505B397DE02F7423FF0634D8352A92765384D877462D47FE2122F2ED79B58627EC23A3C6967B4864B5EA75F11488066AF2DDCE262EDC3A1DFE94AB975160F7CE584C8B215A4817196B9C38156A0D7ED265F9D5C83F635DFB5343D"}}
W
wangzuohuai 已提交
151

Z
zorrosoft 已提交
152
{"req":"Plugin_Update","rid":1,"para":{"Name":"弹窗小程序范例(C#语言)","PID":"PluginExeDemo","Date":"2021-10-23","Desc":"弹窗小程序范例(C#语言)-演示脚本请求打开指定网站","DownAddr":"http://local.zorrosoft.com/Files/Net/PluginExeDemo_Update.pid","MD5":"645C0AA37E5EC4AE780CA1002987B491","Version":"2.2.8.1","Size":622592,"HideIns":0,"Type":2,"Cookie":"","Auth":"","TK":"49277023360979A3A1878D5633F6C15A72D35EA5868ACCFF35BB95000BAAB5227860F6408FC327C423B49D2BD4E6BB7404D89BED95A99C60D97649F337494725BD288FAC7CE151FFD6516145593A0CB25CB22CD6071E5C3EB3A5099F295740A71B6E6961361C8D4B0202D4D5B7BD3269ABF9FC0195D33C971500F27FEA20EA05CE8FC7B439A6CC9B9A2D2AADF58BA7DBB6CF65C999645205F37306FB58E24CC2279FD6AC7CA789B4B8672D0708F59BD01C35F9B4766444B2A14C44CCFCE594846C74A9A86A82AC8CFAAFCD0642730912A9453CE85BC9A21E1EC559D2DFB03BE100F52809BFF4A304E610A3340EFDE61327ED9168208CD7DC390CB99336744188"}}
W
wangzuohuai 已提交
153

W
wangzuohuai 已提交
154
17)、卸载小程序:
W
wangzuohuai 已提交
155
正式版需要添加TK校验,具体规则请参考SDK包中文档“PluginOK中间件安全解决方案.pdf”,可在SDK包中的打包程序ZbaPackage.exe的中间件维护生成带TK的请求。
W
wangzuohuai 已提交
156
举例:
W
wangzuohuai 已提交
157 158 159 160 161
{"req":"Plugin_Remove","rid":50,"para":{"PID":"99225C6D-B7A3-441c-AEFB-3EE23ACA2209","Type":2}}
{"req":"Plugin_Remove","rid":51,"para":{"PID":"F90B1CF0-8485-40ec-B4E8-B87598AAB35D","Type":2}}
{"req":"Plugin_Remove","rid":52,"para":{"PID":"A22E18F1-95F8-4FDB-99D2-188E5FB12B23","Type":1}}
{"req":"Plugin_Remove","rid":53,"para":{"PID":"D10495F4-DF0F-44FA-8647-91275347214A","Type":1}}

W
wangzuohuai 已提交
162
18)、前端请求卸载中间件:
W
wangzuohuai 已提交
163
正式版需要添加TK校验,具体规则请参考SDK包中文档“PluginOK中间件安全解决方案.pdf”,可在SDK包中的打包程序ZbaPackage.exe的中间件维护生成带TK的请求。
W
wangzuohuai 已提交
164
举例:
W
wangzuohuai 已提交
165
{"req":"Wrl_Remove","rid":22,"para":{}}
W
wangzuohuai 已提交
166
说明:连接主服务后可执行;
W
wangzuohuai 已提交
167

W
wangzuohuai 已提交
168
19)、移除本机中间件授权并卸载程序:
W
wangzuohuai 已提交
169
正式版需要添加TK校验,具体规则请参考SDK包中文档“PluginOK中间件安全解决方案.pdf”,可在SDK包中的打包程序ZbaPackage.exe的中间件维护生成带TK的请求。
W
wangzuohuai 已提交
170
举例:
W
wangzuohuai 已提交
171
{"req":"Wrl_RemoveAuth","rid":23,"para":{}}
W
wangzuohuai 已提交
172
说明:连接主服务后可执行;
W
wangzuohuai 已提交
173

Z
zorrosoft 已提交
174 175 176
20)、前端请求显卡配置信息:
举例:
{"req":"Wrl_GetVideoCard","rid":24,"para":{}}
Z
zorrosoft 已提交
177 178
返回举例:{"ret":0,"rid":140,"data":[{"HAL":1,"DID":8081,"Desc":"NVIDIA GeForce GTX 1650","VID":"4318","Revision":"161"},{"HAL":0,"DID":16027,"Desc":"Intel(R) UHD Graphics 630","VID":"32902","Revision":"0"}]}
返回中HAL为1的代表支持硬件抽象层的独立显卡
Z
zorrosoft 已提交
179 180
说明:连接主服务后可执行;

W
wangzuohuai 已提交
181 182 183 184 185 186
2)、刷新中间件授权请求:
如服务器上对应授权已更新,前端可请求强制获取。
举例:
{"req":"Wrl_UpdateAuth","rid":2,"para":{}}
说明:连接主服务后可执行。

W
wangzuohuai 已提交
187
4、PluginOK(牛插)中间件升级请求:
W
wangzuohuai 已提交
188

Z
zorrosoft 已提交
189
{"req":"Wrl_Update","rid":1,"para":{"Name":"PluginOK中间件网络版升级包","Date":"2023-02-08","Desc":"1、优化Windows 8及以上版本水印版文字显示效果及对小程序窗口做透明或半透明的效果;2、优化中间件及网络版的授权服务自动恢复逻辑;3、网络版授权服务器接入新网卡不再影响使用,对终端电脑增加审核转自动和自动转审核的授权模式,并可对每个电脑实现单独配置;4、海康及多引擎网页播放器支持叠加指定网页内容,支持透明或半透明叠加显示...","DownAddr":"http://local.zorrosoft.com/Files/Update/Zba_Update.pid","MD5":"B2AA791181D85158B20DA1E41517F33C","Version":"2.2.9.1","Size":13139968,"HideIns":0,"Cookie":"","Auth":"","Open":"","TK":"94911407BF5BB2B85F5E3D9B729DD175DC8D7A289C769B97C893F6844A677D703D68E50059CDAA62E6A4F58158623A861181EF541BA9DEE5974CBBF8B8C2AE1314BD6EC914AF4F7857B9F48761BC549F90525743AE893E2221DF1353115BB8F6E310A2C36744BCA001AFE0E1A484ECA92EAA0612DE5A6A33F51FFB58C63705B24599A24E603E394E112021BEEDF2151F4D89EDDAF3358DCD35C9240484D1758B95FEB24305F5009EE7EF09FBFD4A1F6BC689A7FC259C641BF93CB9DB831C39D32813D3EC7727C49C5129786AEBD4620DE045AAAA464CB2D0F338B091BDE694A56F3FFDEB9461FB431373968CACEDD2BE66DF6A07DCA414E513D9ACAD9D9B20E5"}}
W
wangzuohuai 已提交
190

W
wangzuohuai 已提交
191 192
5、请求启动弹窗小程序(C++语言)服务,下面以IE控件(ActiveX)演示调用流程及范例:
1)、打开测试网页,输入连接地址:
W
wangzuohuai 已提交
193
ws://wrl.zorrosoft.com:83?sid=321&pid=PluginWinExe&flag=1 
W
wangzuohuai 已提交
194 195
执行连接,会直接启动PluginWinExe.exe程序,界面会返回小程序使用的端口,默认12800;
2)、再次打开一个测试网页,输入连接地址:
W
wangzuohuai 已提交
196
ws://wrl.zorrosoft.com:12800?sid=888&flag=1 
W
wangzuohuai 已提交
197 198 199
执行连接,小程序会提示有新连接;
3)、请求打开指定网站:
在测试网页中输入内容:
W
wangzuohuai 已提交
200
{"req":"Demo_OpenUrl","rid":1,"para":{"url" : "http://www.baidu.com"}} 
W
wangzuohuai 已提交
201
然后点击发送,小程序PluginWinExe.exe会自动打开指定的网页
W
wangzuohuai 已提交
202
4)、将连接pid替换为PluginExeDemo,可以测试C#版实现的类似小程序功能,默认侦听端口是12900。
W
wangzuohuai 已提交
203

W
wangzuohuai 已提交
204 205
6、请求启动无窗口小程序(C++语言)服务:
1)、打开测试网页,输入连接地址:
W
wangzuohuai 已提交
206
ws://wrl.zorrosoft.com:83?sid=666&pid=C38672FA-B5C8-4D9D-89B5-2D71F0760661&flag=1 
W
wangzuohuai 已提交
207 208 209 210 211
连接请求指定pid的服务;
2)、发送框输入内容以下内容并发送,实现写入内容到我的文档目录记事本文件中:
{"req":"Demo_WriteFile","rid":20,"para":{"Name" : "文件小程序.txt","Content" : "这是测试写入的内容!"}}
3)、发送框输入内容以下内容并发送,实现写读取指定文件内容:
{"req":"Demo_ReadFile","rid":21,"para":{"Name" : "文件小程序.txt"}}
W
wangzuohuai 已提交
212

W
wangzuohuai 已提交
213
7、请求启动无窗口小程序(C#语言)服务,连接地址:
W
wangzuohuai 已提交
214
ws://wrl.zorrosoft.com:83?sid=666&pid=FCADA8A7-D975-42c6-B5D3-FA40F6FE1286&flag=1 
W
wangzuohuai 已提交
215
其它步骤参考 无窗口小程序(C++语言)。
W
wangzuohuai 已提交
216

W
wangzuohuai 已提交
217
8、请求启动弹窗小程序(C#语言)服务,连接地址:
W
wangzuohuai 已提交
218
ws://wrl.zorrosoft.com:83?sid=666&pid=PluginExeDemo&flag=1 
W
wangzuohuai 已提交
219
其它步骤参考 弹窗小程序(C++语言)。
W
wangzuohuai 已提交
220

W
wangzuohuai 已提交
221
请求参数的JSON数据包,请确保是UTF-8无签名的编码。如还有疑问,请加微信ZorroSoft 或QQ群23126938 联系相关人员提供技术支持服务