猿大师中间件微软Office内嵌网页小程序开发文档_猿大师

猿大师播放器 —— 网页超低延迟播放海康威视、大华、华为RTSP视频流方案

猿大师办公助手 —— 网页内嵌微软Office、金山WPS及永中Office方案

猿大师中间件 —— 网页调用本地硬件软件，如打印机、高拍仪、AutoCAD等

说明：以下功能请通过Web Socket连接猿大师主服务(ws://localhost?sid=12345&flag=1)后可执行，如默认侦听端口不是80(关于如何配置侦听端口，请参考SDK包中的文档“猿大师开发者手册.doc”)，请在连接地址中指定端口号进行连接。
HTTP网页在线测试： http://test.yuanmaster.com/wordfull.html
HTTPS网页在线测试： https://test.yuanmaster.com/officeframe.html
前端集成可参考以上测试网页进行，HTML网页中需要嵌入以下类似代码； A、标记小程序的显示位置和大小 .OfficeApplet { margin: 20px 0 0 20px; width: 480px; height: 320px; border: 1px solid blue; .OfficeApplet { width: 480px; height: 320px; top: 20px; left: 20px; border: 1px solid blue; 如果在网页Header区没有标记小程序初始显示位置和大小，请在启动小程序的JSON参数里，添加以下参数： "Left":20,"Top":20,"Width":480,"Height":320 B、网页中嵌入元素支持IFrame的： <iframe name="OfficeApplet" id="OfficeApplet" src="OfficeApplet3.html" frameborder="0" align="left" width="550" height="540" scrolling="no"> 或者直接用 <div id="OfficeApplet" class="OfficeApplet"</div> 另外需要嵌入用到的JS脚本，脚本程序是完全开源的。 1)、请求启动微软Office内嵌网页小程序实现网页中局部加载doc/xls/ppt等文档显示： Type为浏览器类型，传0自动判断(前提是当前浏览器已启动并显示在最前端，Flag指定当前页加载时必须是0) 可强制指定浏览器类型Type(2代表Chrome 4代表Firefox 8代表Opera 16代表Edge(Chromium内核) 32代表360极速浏览器 33代表360安全浏览器 34代表360企业安全浏览器 50代表QQ浏览器 60代表搜狗浏览器) Title：网页标题中的关键词 Flag掩码标记：1指定新标签加载(1和16都不指定时为当前页加载) 2小程序显示窗口边框 4不自动裁剪越界窗口 8自动适配网页高度和宽度显示 64根据标题避免重复加载相同的小程序 IframeX和IframeY分别为iframe嵌套的横竖偏移修正坐标 BarW和BarH分别是网页右侧和底部预留区域小程序实际显示首先会基于网页中指定的坐标和大小，再根据IframeX、IframeY、BarW、BarH设定的值做修正 OType 1启动微软Word;OType 2启动微软Excel;OType 3启动微软PPT Url：加载小程序所在的网页实际地址 Open：为需要打开的文档路径，磁盘目录斜杠用/ 注意：Open和Url如果有特殊字符或中文等，需要用URL编码处理后传递自动识别当前浏览器并启动微软Word程序 {"req":"Wrl_OfficeApplet","rid":5,"para":{"Type":"0","Title":"Office Applet","Flag":0,"IframeX":0,"IframeY":0,"BarW":0,"BarH":0,"Url": "http://test.yuanmaster.com/OfficeApplet2.html","OType":"1","Open":"D:/Zorro/test.doc"}} 自动识别当前浏览器并启动微软Excel程序 {"req":"Wrl_OfficeApplet","rid":6,"para":{"Type":"0","Title":"Office Applet","Flag":0,"IframeX":0,"IframeY":0,"BarW":0,"BarH":0,"Url": "http://test.yuanmaster.com/OfficeApplet2.html","OType":"2","Open":"D:/Zorro/test.xls"}} 自动识别当前浏览器并启动微软PPT程序 {"req":"Wrl_OfficeApplet","rid":7,"para":{"Type":"0","Title":"Office Applet","Flag":0,"IframeX":0,"IframeY":0,"BarW":0,"BarH":0,"Url": "http://test.yuanmaster.com/OfficeApplet2.html","OType":"3","Open":"D:/Zorro/test.ppt"}} 自动识别当前浏览器指定位置自动适配网页大小启动： {"req":"Wrl_OfficeApplet","rid":8,"para":{"Type":"0","Title":"Office Applet","Flag":8,"IframeX":0,"IframeY":0,"BarW":0,"BarH":0,"Url": "http://test.yuanmaster.com/OfficeApplet2.html","OType":"1","Open":"D:/Zorro/test.doc"}} 当前页指定位置自动适配网页加载测试 http://test.yuanmaster.com/officeframe.html 启动后会先后收到三个JSON数据包 A、{"ret":0,"rid":1,"data":{"ID":3}} 代表小程序WS侦听服务就绪 B、{"event":"Wrl_Listen","aid":3,"data":{"SID":"123","PID":"MSOfficeApplet","port":950}} 返回的侦听端口，可再建立一个Web Socket连接后，调用小程序中的相关功能，比如打开一个文档。代表小程序创建成功，返回ID为当前小程序运行ID，通过此ID，可执行Wrl_AppletControl、Wrl_AppletScroll、Wrl_AppletResize等命令。 C、{"event":"Wrl_AppletOK","aid":3,"data":{"SID":"123","PID":"MSOfficeApplet","Port":950}} 2)、请求控制微软Office内嵌网页小程序：当前端不再需要小程序时可指定关闭，或者显示/隐藏及全屏显示等 ID为启动小程序时返回JSON中的ID值，Code代表控制类型掩码：1关闭 2全屏显示 4自动隐藏 8还原显示 16自动适配网页高度和宽度显示模式切换 32强制隐藏。其中全屏显示2，可直接通过热键ESC或取消,4和32隐藏后可通过8恢复显示 {"req":"Wrl_AppletControl","rid":2,"para":{"ID":"1","Code":4}} 3)、请求滚动微软Office内嵌网页小程序：当前端截取到网页滚动通知时，需要调用此接口实现小程序和网页的滚动联动 ID为启动小程序时返回JSON中的ID值 Code为滚动方向1是水平直，2是垂直，3是同时 Left为横向滚动条位置，Top为纵向滚动条位置 {"req":"Wrl_AppletScroll","rid":3,"para":{"ID":"1","Code":2,"Left":0,"Top":100}} 4)、请求改变微软Office内嵌网页小程序显示位置或大小：当前端网页显示区域缩放时，可动态修改小程序的显示位置或大小 ID为启动小程序时返回JSON中的ID值，Width和Height分别为新的宽度和高度，X和Y分别为新的显示位置，不指定时保持不变，指定时原设置的IframeX和IframeY失效 {"req":"Wrl_AppletResize","rid":4,"para":{"ID":1,"Width":500,"Height":600}} 或同时设置小程序显示起始坐标 {"req":"Wrl_AppletResize","rid":5,"para":{"ID":1,"Width":500,"Height":600,"X":20,"Y":20}} 5)、请求设置网页预留右侧宽度和底部高度，滚动条信息、垂直滚动及水平滚动位置：当小程序显示区域超过当前网页时，需去除滚动条的显示影响 ID为启动小程序时返回JSON中的ID值，BarW为预留右侧宽度 BarH为预留底部高度 Code 1代表有水平滚动条，2代表有垂直滚动条，3代表都有 ScrollTop垂直滚动条位置 ScrollTop水平滚动条位置 {"req":"Wrl_ScrollBar","rid":6,"para":{"ID":"1","Code":2,"BarW":0,"BarH":0,"ScrollTop":0,"ScrollLeft":0}} 6)、请求对小程序窗口做Alpha透明处理，便于前端临时显示覆盖到小程序窗口的菜单等： ID为Wrl_OfficeApplet启动小程序时返回的ID值，Alpha为透明度百分比，1-100 {"req":"Wrl_AppletAlpha","rid":7,"para":{"ID":1,"Alpha":30}} 7)、请求对小程序窗口内容进行截图： ID为启动小程序时返回JSON中的ID值， File为指定截图文件保存路径或扩展名 Base64指定为1时代表返回BASE64编码的图像内容 {"req":"Wrl_AppletSnap","rid":10,"para":{"ID":1,"Base64":1,"File":".png"}} 8)、请求缩放IE控件内嵌网页小程序，用于浏览器网页按比例缩放，一般不需要处理： ID为启动小程序时返回JSON中的ID值，Scall为缩放百分比 {"req":"Wrl_AppletScale","rid":11,"para":{"ID":1,"Scale":120}} 3、小程序安装、升级、卸载 1)、请求安装微软Office内嵌网页小程序请在输入框中，输入如下请求，然后点击发送，完成安装： {"req":"Plugin_Install","rid":1,"para":{"Name":"微软Office在线编辑小程序","PID":"MSOfficeApplet","Date":"2021-03-27","Desc":"猿大师之上跨浏览器的微软Office内嵌网页小程序，支持在Chrome、Edge、Firefox、IE、Oprea、360、QQ等最新版本浏览器网页中内嵌Word、Excel、PowerPoint等程序进行在线编辑或审阅各类办公文档","DownAddr":"http://local.zorrosoft.com/Files/Net/MSOfficeApplet.pid","MD5":"D6748F2B79AE2131F86FA2D5C956D865","Version":"2.1.3.1","Size":753664,"HideIns":0,"Type":8,"Cookie":"","Auth":"","TK":"A117CE98035ED7420C7AACF50B32E292D96C030D462F4EFD607F047F20DA0CA5609113566C234D77CEB5424ADB072E035409D26E7DF7E4241F09B7E0EBAA4B6B772864EBB4922A911DDA715CEE550DB26CA0F886D0283BAD5E8166931CA7D892A965953F6FFE9E0E0C7A50397E0BA504FDD72D56EB2366819ABDF79054DF8211D7B1CA115CA96B001BEEF20ABFF100D87647EC42A2253611AD43536FF3393699867886A713E93FF342A13152D6EC9769139ED915BD3E3CA43B9C801D6BC5414DFAE1F362DA5BAA48C6F23C3809136DAE3CF8CD7C4C2DA013666259E1F79A2BF48FE74CC1B63CBE80D5A713A47F61B0E7A729DBB3E3BA4EF3033628F5FC928E1D"}} 启动安装后，会不断收到安装进度直到安装结束。在发布时，也可以把此小程序目录文件和中间件一起打包后发布，不用单独分发。 2)、请求升级微软Office内嵌网页小程序： {"req":"Plugin_Update","rid":1,"para":{"Name":"微软Office在线编辑小程序","PID":"MSOfficeApplet","Date":"2021-03-27","Desc":"猿大师之上跨浏览器的微软Office内嵌网页小程序，支持在Chrome、Edge、Firefox、IE、Oprea、360、QQ等最新版本浏览器网页中内嵌Word、Excel、PowerPoint等程序进行在线编辑或审阅各类办公文档","DownAddr":"http://local.zorrosoft.com/Files/Net/MSOfficeApplet_Update.pid","MD5":"58603A04407BD4347AE90A5ABA9748DE","Version":"2.1.3.1","Size":753664,"HideIns":0,"Type":8,"Cookie":"","Auth":"","TK":"AAA68F2FB46F40B060F62123467EEE9C72D41040A55C5DD5D16C89A288B36A993A0FE0D014A33985EFAE8C9DD0AFD36D5964E4FBF8EECB3AD79283F90323D57EE49A99D2B658A268287D0ABD80AA52F9A5F0646219F29990EA76928FF2E9F5DC290906FE9FA5E069A15B34B37A47195C298C0312972B1E1A30014C6804C7D1E3E8E4ACDBA0637EC2CEA145A23657B54063A4DF49BED099F018C9F481EBF14B82ECF77B628DAB8788C47BAFEB4DAB37177670319DD19E308D7454EB6C631869E70E1672D2EF1BC82396B08468EF55E464DD55271F0AE62FF1F76552FB0658279F0E61EBB4A0FEA575A3E24A40029EDE419365435D5C514EE11A3CF175FE3A7C2F"}} 以上安装和升级的JSON请求包，可能因版本升级导致内容不同，如遇安装或升级时报错，请联系客服获取最新的请求包。 3)、请求卸载微软Office内嵌网页小程序： {"req":"Plugin_Remove","rid":3,"para":{"PID":"MSOfficeApplet","Type":8}} 4、微软Office内嵌网页小程序转调用Office软件的VBA接口，先根据Wrl_OfficeApplet请求启动后返回的端口号，新建立一个WebSocket连接后可执行如下指令： A、常用功能请求：请求退出小程序 {"req":"Office_Exit","rid":1,"para":{}} 请求关闭文档 {"req":"Office_Close","rid":2,"para":{}} 请求打开文档 {"req":"Office_Open","rid":3,"para":{"Open":"D:/Zorro/test.doc"}} /// 请求转换为PDF格式 {"req":"Office_SaveAs","rid":4,"para":{"NewFile":"D:/Zorro/test1.pdf"}} 5、事件通知： B、猿大师支持的事件通知： 1) 小程序是否响应了热键全屏以下分别为Word字处理、Excel表格、Powerpoint演示程序的全屏事件通知 {"event":"WORD_FullScreen","data":{"FullScreen":0}} FullScreen为当前是否全屏标记 {"event":"EXCEL_FullScreen","data":{"FullScreen":0}} FullScreen为当前是否全屏标记 {"event":"PPT_FullScreen","data":{"FullScreen":0}} FullScreen为当前是否全屏标记 2) Wrl_AppletExit 小程序退出通知 {"event":"Wrl_AppletExit","data":{"ID":1}} 请求参数的JSON数据包，请确保是UTF-8无签名的编码。更多接口请求说明，请参考安装目录中的文档TestWrl.txt、SDK包中的“猿大师开发者手册.doc”及“猿大师中间件安全解决方案”。如还有疑问请直接联系客服。

上一篇 : 猿大师中间件金山WPS内嵌网页小程序开发文档

下一篇 : 猿大师中间件VLC播放器内嵌网页小程序开发文档

猿大师中间件微软Office内嵌网页小程序开发文档

猿大师中间件腾讯软件内嵌网页小程序开发文档

猿大师中间件Flash Player内嵌网页小程序开发文档

猿大师中间件IE控件内嵌网页小程序开发文档

猿大师中间件点聚AIP电子签章网页内嵌小程序开发文档

猿大师中间件Autodesk内嵌网页小程序开发文档