AppEmit中间件

AppEmit是应用程序（尤其是浏览器）与本地程序间互相通信的易扩展的轻量级中间件

AppEmit 中间件说明书

程序名称	AppEmit.exe
程序版本	v1.0.0
说明书版本	v1.0.0
网址	http://www.appemit.com
Email	[email protected]
修改时间	2020年8月29日
修订	v1.0.3

概述

AppEmit是应用程序（尤其是浏览器）与本地程序间互相通信的易扩展的轻量级中间件。

AppEmit is an extensible lightweight middleware for communication between applications (especially browsers) and local programs.

主要采用了HTML5国际标准的Web Socket进行通话，默认为异步， JSON格式传递参数。

主要功能：

在几乎所有浏览器播放含有flash的网页或Flash文件，包括swf交互动画、flv影视等
在浏览器打开、操作本地文件，比如阅读PDF；创建、阅读、编辑Office文件，且支持JavaScript代码操作
在浏览器中调用第三方DLL、OCX等ActiveX组件以及系统winApi函数，tcc、python、lua等
开发本地硬件DLL的插件，实现在网页中操作控制本地的读卡器、打印机、扫描仪、高拍仪、U盾等各种硬件设备
各个应用程序之间通信，比如聊天
在Chrome里嵌入IE内核网页，保护源码，可以不修改原有的ActiveX读取html，同时支持开源内核wke和blink

解决问题

国际市场份额68%以上的chrome浏览器（数据来源Netmarketshare；国内25%以上）在2020年12月后不再支持flash，而微软的edge也不支持ActiveX。
客户习惯使用浏览器来处理各种业务。
游戏商、银行、医院、电力、硬件等企业客户在各种浏览器中开发调用dll、ocx、ActiveX、com组件、flash等文件的场景需要。

相关链接

程序名称 AppEmit.exe

网址 http://www.appemit.com

Github https://github.com/appemit/appemit

Email联系 appemit(at)appemit.com

内容分发下载地址 github下载地址

1. 具体功能

支持同步、异步（默认）处理消息或者消息组

支持一个页面打开多个APP

支持本地文件和网络文件访问

支持获取硬件信息，包括系统、CPU、主板、显卡、内存、硬盘、网络等

支持USB监控

支持pcomm串口异步多线程调用

支持用户间通信、发送接收消息

支持使用IE、webkit、blink内核打开，互动网页

支持打开、互动flash,包括ActiveX flash和NPflash

支持多媒体播放

支持打开、编辑、代码互动microsoft office、金山office的world、excel、ppt，支持本地文档和网络文档处理

支持打开PDF

支持调用第三方dll、com等链接库

支持开发dll等

1. 使用条件
  1. 系统

Windows系统，支持XP以上。

软件/插件	功能/方式	依赖条件	说明
AppEmit		Windows系统XP以上	32位, 可以运行在x64、 x86上
flash	调用本地flash AcitveX控件，打开swf文件	本地安装flash AcitveX控件
flash	打开网络中含有swf的网页打开网络中的文件swf	自动安装插件	或者下载完全插件版本可局域网使用。后续同。
IE	打开网络中含有swf的网页采用不同内核IE\webkit打开网络或者本地网页	-
PDF	阅读网络或者本地PDF文件	-
Office	打开、编辑Office文档	本地安装Office
媒体文件	打开网络中的文件视频格式：mp4、flv、m3u8、rtmp 视频编码：H.264 音频编码：AAC、MP3 音频格式：MP3等文件	-

1. 1. 用法

在windows系统中，下载免安装程序AppEmit（不含插件小于6M），运行AppEmit.exe即可。设置了开机自启动，应避免被杀毒软件关闭。

同时只能开启一个AppEmit.exe进程。

1. 技术实现
  1. 技术依赖

采用开源或公共控件，安全可靠。

Web Socket采用开源控件HPSocket（https://github.com/ldcsaa/HP-Socket），支持ssl。

Dll文件开放了C接口，可以在此基础二次开发控件,主要调用

HPSocket4C_U.dll
HPSocket4C-SSL_U.dll

IE内核调用flash Active控件
非IE内核调用flash NPAPI控件
webkit内核采用开源软件wke控件
blink内核采用开源软件miniblink控件
1. 1. 步骤

网页注册后获得设置cid，clientKey，获得连接授权。或者使用临时账户cid=00000-1测试。

一个账户cid目前最多15个，设置cid后不要任意修改，更新数据有1-2小时延迟。

连接Appemit服务

AE_initAppWs("ws://localhost:80/appemit?cid=00000-1&sid=1&flag=1")

设置clientKey授权，(clientKey为私有，发布后需要保密混淆加密js)初始化数据以及授权等

var AE_initSet = {

"emit":"init",

"clientKey": "temp-0000000000", //

"clientInfo":clientInfo,

"wsUrl": wsUrl,

// "flag":0,

// "sid":"123456", // 用户session 或者用户名ID，唯一可以准确通话

"gid": "[1,2]", //用户群ID，一个用户可以加入多个群

// "utf_escape":false, //默认false, 反馈的data编码转义

};

AE_EmitReq_PIP(AE_initSet);

发送命令

AE_OpenApp('{"emit":"hardWare","Obj":"pc","par0":{"dev":["os","base"]}}')

1. 1. demo

在demo下主要是html的举例，

包括获取pc信息，实现通话的index.html
以及播放flash的AppEmbed.html
1. 联系

邮件： [email protected]

插件场景用法
1. 获取客户端信息

使用浏览器打开demo下的index.html。授权连接后，发送获取PC信息命令。

AE_initAppWs("ws://localhost:80/appemit?cid=00000-1&sid=1&flag=1")

AE_OpenApp('{"emit":"hardWare","Obj":"pc","par0":{"dev":["os","base"]}}')

1. 不同客户端通信

打开demo下的index.html,模拟不同sid打开浏览器。

连接Appemit授权后，在sid=1下发送命令。

{"emit":"msg", "Obj":"sid","toSids":["2"],"toGids":[1,2],"data":"hi, I am Tom."}

在客户cid全集下，通过唯一的sid对话，可以一对一，或者一对多通话。

图为1对2和3通话。

另外还可以设置不同群gid，一个sid可以加入不同的gid。

发送消息时，在cid全集下，所有的toSids和toGids取对应的sid交集剔重，并排除自身。

1. 打开文件

已系统默认的程序，打开文件。

为了安全，不支持直接打开的类型包括

{"exe";"msi";"cmd";"js";"jar";"inf";"com";"scr";"reg";"bat";"vbs";"py"}

发送命令打开文件，以独立的方式打开，和浏览器没有关系。

{"emit":"open", "Obj":"file","AppShow":false,"src":["/demo/htmlDemo/file/d1.docx",null,null,1]}

src：EXE文件路径, 启动参数="",操作类型 = "open",显示属性 _SW_,工作目录=""

1. Flash

两种方法，主要四种形式实现场景

使用客户端本地安装的Flash Player ActiveX控件，要是客户端没有，需要自行下载。下载地址：http://www.adobe.com/go/getflashplayer
使用Appemit程序自带的插件plugins/NPSWF32.dll

1. 1. NPAPI-嵌入web

能打开常用网页，目前的插件不支持html5的媒体特性。如有需要，可以使用node或者electron插件。

使用webkit内核使用Appemit程序自带的插件NPSWF32.dll，能打开嵌有flash的网页，不默认具有右键菜单。

连接授权后，发送命令"AppType":1的形式。

{"emit":"open","Obj":"flash","AppType":1,"src":"http://sxiao.4399.com/4399swf/upload_swf/ftp14/yzg/20140328/bombit7/zx_game7.htm","pos":1}

1. 1. NPAPI-网络flash文件

使用Appemit程序自带的插件NPSWF32.dll，打开网络flash文件。

连接授权后，发送命令"AppType":2的形式。

{"emit":"open","Obj":"flash","AppType":2,"src":"http://sxiao.4399.com/4399swf/upload_swf/ftp18/liuxy/20160130/17801/game.swf","pos":1,"par0":{"autoPlay":true,"loop":true,"quality":"high","wmode":"Transparent"}}

1. 1. NPAPI-网络媒体文件

使用Appemit程序自带的插件NPSWF32.dll，打开网络媒体文件，包括flv,mp4等。

连接授权后，发送命令"AppType":3的形式。

{"emit":"open","Obj":"flash","AppType":3,"src":"https://media.html5media.info/video.mp4","pos":1,"par0":{"autoPlay":1,"loop":1}}

1. 1. ActiveX形式
    1. 打开网络flash文件

打开demo下的AppEmbed.html,连接授权后，发送使用ActiveX（"AppType":4）打开网络flash文件命令，参数如下。

{"emit":"open","Obj":"flash","AppType":4,"src":"http://img1.yo4399.com/swf/00/0ff035e0e96584c07df65ab3636f72.swf","pos":1,"par0":{"autoPlay":1,"toolbar":0,"rightMenu":0,"hitCaption":0,"hideStop":0,"loop":1,"volumeMute":0,"flashVars":"a=0&b=0&c=SetInSrc"}}

注意事项：

在客户端需要下载安装flash player ActiveX。

路径是 / 或许 \\

flashVars可以设置在src中

AppType正数为嵌入APP，负数为浮动窗口，后同。

刷新即可关闭flash

1. 1. 1. 打开本地flash文件

可以是绝对或者相对路径，相对于AppEmit.exe的路径："demo/htmlDemo/test1.swf"。

{"emit":"open","Obj":"flash","AppType":4,"src":"demo/htmlDemo/test1.swf","pos":1,"par0":{"autoPlay":1,"toolbar":0,"rightMenu":0,"hitCaption":0,"hideStop":0,"loop":1,"volumeMute":0,"flashVars":"a=0&b=0&c=SetInSrc"}}

1. 1. 关闭
刷新即可关闭flash
{"emit":"close","AppId":1} //空时默认追加AppId 1
{"emit":"closeAll"}
1. Web

具有右键菜单。

1. 1. IE 内核

"AppType":1使用IE内核打开网页

{"emit":"open","Obj":"web","AppType":1,"pos":1,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"http://www.appemit.com"},"par0":{"header":null,"noScriptErr":true, "UIFLAG":null,"DLCTL":null,"userAgent":null,"crossDomain":true}}

设置htmlStr可以直接打开html源码。

设置HttpServer_startUrl，可以打开本地的html文件。

设置URL打开网页。三者优先级依次下降。

1. 1. Webkit内核

"AppType":2使用webkit开源内核打开网页

{"emit":"open","Obj":"web","AppType":2,"pos":1,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"http://www.appemit.com"},"par0":{"header":null, "userAgent":null,"crossDomain":true,"downLoad":1}}

设置htmlStr可以直接打开html源码。

设置HttpServer_startUrl，可以打开本地的html文件。

设置URL打开网页。三者优先级依次下降。

1. 1. blink内核

"AppType":3使用开源blink内核(webkit加强版)打开网页，可以浏览网页，支持前进后退刷新复制粘贴，支持下载。

{"emit":"open","Obj":"web","AppType":3,"pos":1,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"http://www.appemit.com"},"par0":{"header":null, "userAgent":null,"crossDomain":true,"downLoad":1}}

设置htmlStr可以直接打开html源码。

设置HttpServer_startUrl，可以打开本地的html文件。

设置URL打开网页。三者优先级依次下降。

1. office
  1. PDF

"AppType":4使用开源blink内核打开阅读PDF文件，支持本地和网络PDF。

{"emit":"open","Obj":"web","AppType":4,"pos":1,"par":{"URL":"/demo/AppEmit_help.pdf","par0":{"rightMenu":1}}}

设置URL打开PDF文件。

1. 1. Office

使用微软com技术创建、打开阅读、编辑Office，包括word\excel\PPT文件，支持本地和网络文件。

支持在javaScript中添加类似VBA代码动态控制,同时可以在浏览器网页里执行命令。

1. 1. Wps

使用 com技术创建、打开阅读、编辑金山wps ，包括wps\et\wpp文件，支持本地和网络文件。

支持在javaScript中添加类似VBA代码动态控制,同时可以在浏览器网页里执行命令。

1. 1. Office DsoFramer （不稳定）

使用微软开源控件DsoFramer创建、打开阅读、编辑Office，包括word\excel\PPT文件，支持本地和网络文件。

{"emit":"open",

"Obj":"office",

"AppType":1,

"src":"/demo/htmlDemo/file/x1.xls",

"pos":1,

"par0":{"Caption":true,

"ProtectDoc":0,

"Toolbars":true,

"btnFile":true,

"MNU_NEWBLANK":0,

"MNU_NEW":0,

"MNU_OPEN":0,

"MNU_CLOSE":0,

"MNU_SAVE":0,

"MNU_SAVEAS":0,

"MNU_PGSETUP":0,

"MNU_PRINT":0,

"MNU_PROPS":0,

"show_UpdateTool":true}

}

设置src打开office文件。

1. DLL等组件调用

主要有三种方法来实现。

通过打开IE内核，来createObject调用ActiveX ,一般调用ActiveX需要已经注册
JS控制AppEmit调用DLL接口，互动信息，有些ActiveX可以免注册。

可以调用标准的COM组件、ActiveX以及DLL，支持可视化ocx，同时可以开发互动的dll，能在浏览器中控制调用的组件或者程序。

APP

嵌入网页JS

浏览器网页

AppEmit

1. 1. 使用IE内核打开ActiveX

使用IE内核打开网页,在非IE浏览器中调用activeX控件,及使用原有的html的代码即可。

{"emit":"open","Obj":"web","AppType":1,"pos":1,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"http://www.baidu.com"},"par0":{"header":null,"noScriptErr":true, "UIFLAG":null,"DLCTL":null,"userAgent":null,"crossDomain":true}}

设置htmlStr可以直接打开html源码。

设置HttpServer_startUrl，可以打开本地的html文件。

设置URL打开网页。三者优先级依次下降。

同时也能通过浏览器网页发布命令。

1. 1. JS控制AppEmit调用可视化com组件
Flash ocx 调用，能在网页中执行命令，控制flash,举例见demo/htmlDemo/dll.html

{"emit":"open","Obj":"dll","AppType":1,"src":[],"pos":1,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"/demo/htmlDemo/js/dllJs.html","webJs":1}

调用C:/Windows/SysWOW64/Macromed/Flash/Flash32_32_0_0_403.ocx 控件，需要自行安装flash.

可以在dllJs.html进一步设置参数AppType==1情况，和过程调用代码。

同时也能通过浏览器网页发布命令。

第三方控件ReportX.ocx，联系AppEmit检查安全性后配置在/plugins/thirdparty目录中，直接调用

报表控件reportX调用。

能在网页中执行命令，控制reportX,举例见demo/htmlDemo/dll.html

{"emit":"open","Obj":"dll","AppType":2,"src":[],"pos":1,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"/demo/htmlDemo/js/dllJs.html","webJs":1},"par0":{"AppMethod":"msg Synchronization component need set: POST" }}

调用"/plugins/thirdparty/report/ReportX.ocx" 控件

可以在dllJs.html进一步设置参数AppType==2情况，和过程调用代码。

同时也能通过浏览器网页发布命令。

1. 1. JS控制AppEmit调用第三方Dll
dll 调用，第三方控件，联系AppEmit检查安全性后配置在/plugins/thirdparty目录中，直接调用，能在网页中执行命令,举例见demo/htmlDemo/dll.html

{"emit":"open","Obj":"dll","AppType":4,"src":[],"AppShow":false,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"/demo/htmlDemo/js/dllJs.html","webJs":1 },"par0":{"AppMethod":"msg Synchronization component need set: POST" }}

可以在dllJs.html进一步设置参数AppType==4情况，和过程调用代码，演示调用add方法。

同时也能通过浏览器网页发布命令。

1. Dll开发

可以通过2种方法来实现

开发的DLL可以和AppEmit保持接口一致，完成通信调用。
注册开发的DLL，在非IE浏览器打开IE内核来调用，见web IE内核章节。

下面介绍第一种方法，自有开发的私人DLL或者组件，需要申请Pid后开发dll,安装在/plugins/private/目录下，需要双方验证成功后才能调用

参考demo/htmlDemo/dll/dll_demo1.c,提供了接口规范。使用最新版本TCC开发的dll。

调用dll_demo1.dll，能在嵌入网页中执行命令，控制dll_demo1,举例见demo/htmlDemo/dll.html

{"emit":"open","Obj":"dll","AppType":3,"src":[],"AppShow":false,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"/demo/htmlDemo/js/dllJs.html","webJs":1 },"par0":{"AppMethod":"msg Synchronization component need set: POST" }}

调用/plugins/private/50FCF891-1B93-4AE5-8A66-AB26A3C03378/dll_demo1.dll

可以在dllJs.html进一步设置参数AppType==3情况，和过程调用代码。

同时也能通过浏览器网页发布命令runCmd。

1. 插件部署

在发布时，也可以把此AppEmit插件目录文件和AppEmit.exe一起打包后发布，不用单独分发。

名称	路径	作用
blink	/plugins/lib/web/blink/.dll/node.dll	浏览器内核
blink	/plugins/lib/web/blink/.dll/wkex.dll	浏览器内核
flash_NP	/plugins/NPSWF32.dll"	NP版本flash
flash_NP	/plugins/plugin.vch	NP版本flash
aliplayer	/plugins/common/aliplayer	Aliplayer播放器支持视频格式：mp4、flv、m3u8、rtmp 视频编码：H.264 音频编码：AAC、MP3 音频格式：MP3
PDF	/plugins/common/pdfjs	浏览PDF文件

Dll开发
1. 1. 开发

自有开发的私人DLL或者组件，需要申请Pid （pid>=guid=clsId）可使用GUID工具自行生成后开发dll,安装在/plugins/private/目录下，需要双方验证成功后才能调用

参考demo/htmlDemo/dll/dll_demo1.c,提供了接口规范。使用最新版本TCC开发的dll。

主要是5个函数接口,App开头的函数和变量名称不要改变

AppDll_init dll初始化，用户输入参数认证

AppDll_loaded dll启动后执行

AppDll_destroy dll 退出前执行

AppDll_RevMsg 互动时接收消息

AppDll_SendMsg 互动时反馈消息

模板如下,使用了cJSON开源库。

#include

// #include

#include "cJSON.h" 需要下载开源库cJSON

#include "cJSON.c"

// 开发可以互动信息的动态链接库 Dll

// http://www.appemit.com

生成DLL 必须使用最新版tcc扩展库才能支持UTF8,UTF16字符串

入口函数,该函数可以有也可以没有。

入口函数会自动加锁以保证线性调用,要避免在DllMain内调用下列函数:

1、调用LoadLibrary或其他可能加载DLL的API函数( CreateProcess等 )

2、可能再次触发DllMain的函数,例如 CreateThread,ExitThread

3、GetModuleFileName, GetModuleHandle 等其他可能触发系统锁的API函数

总之在DllMain最好不要调用API函数.

主要是5个函数接口,App开头的函数和变量名称不要改变

AppDll_init dll初始化，用户输入参数认证

AppDll_loaded dll启动后执行

AppDll_destroy dll 退出前执行

AppDll_RevMsg 互动时接收消息

AppDll_SendMsg 互动时反馈消息

char *mycid ="00000-1"; //申请的公司产品cid ，需要修改

char *clsId="50FCF891-1B93-4AE5-8A66-AB26A3C03378"; // pid>=guid=clsId 可使用GUID工具自行生成

int dllThid; //本进程ID

// sid; //websocket里面设置的,一般为用户ID或者sessionID，唯一

// rid ; //第rid次调用

int AppAuth=0; //

//测试

char* joinStr(char *s1, char *s2, char *s3)

{

char *result = malloc(strlen(s1)+strlen(s2)+strlen(s3)+1);//+1 for the zero-terminator

if (result == NULL) exit (1);

strcpy(result, s1);

strcat(result, s2);

strcat(result, s3);

return result;

}

int __stdcall DllMain(void * hinstDLL, unsigned long fdwReason, void * lpvReserved) {

if (fdwReason == 1/*DLL_PROCESS_ATTACH*/ ){

}

return 1;

}

//__declspec(dllexport) 声明导出函数

__declspec(dllexport) int AppDll_RevMsg(HWND hwnd, char *ids,char *msg)

{

AppDll_SendMsg(hwnd,ids,msg);

return 0;

}

__declspec(dllexport) int AppDll_SendMsg(HWND hwnd, char *ids,char *msg)

{

//检查是否有 clsId

cJSON * ids_json= cJSON_Parse(ids);

if (!ids_json) {ids_json=cJSON_CreateObject();}

if (!cJSON_GetObjectItem(ids_json,"clsId")) {

cJSON_AddStringToObject(ids_json, "clsId", clsId); //必需字段

}

ids=cJSON_PrintUnformatted(ids_json);

cJSON_Delete(ids_json);

struct {char * ids;char * msg; } callBackMsg = {

.ids=ids,

.msg =msg, // 只会反馈msg里面data字段到websocket

};

SendMessage(

hwnd,0xACCE ,

"AppOnMsg({string ids;string msg;})", //要调用的窗体函数名( 结构体原型声明 ); 结构体原型声明应使用API语法

&callBackMsg //将前面定义的结构体作为调用参数

);

return 0;

0xACCE=_WM_THREAD_CALLBACK 使所有回调安全的转发到UI线程。

_WM_THREAD_CALLBACK 可以跨线程跨语言并且不需要创建回调线程,适用任何普通winform对象。

}

__declspec(dllexport) int AppDll_init(HWND hwnd, char *ids,char *msg)

{

//判断获得AppEmit提供ids(格式json)里面cid sid pid AuthKey等数据

//和websocket的自行web提供的Json里面的data，判断验证来源是否正确

// ids ="{\"cid\":\"00000-1\",\"sid\":\"f1s\",\"rid\":2333,\"AuthKey\":\"000\",\"clsId\":\"50FCF891-1B93-4AE5-8A66-AB26A3C03378\"}";

//具体数据和判断需要修改

cJSON * ids_json= cJSON_Parse(ids);

// char * ids3= cJSON_PrintUnformatted(ids_json); //如果解析报错尝试使用cJSON

// cJSON * ids_json2= cJSON_Parse(ids3);

if (!cJSON_GetObjectItem(ids_json,"clsId") || !cJSON_GetObjectItem(ids_json,"cid") || !cJSON_GetObjectItem(ids_json,"AuthKey")) { cJSON_Delete(ids_json);return -1;}

dllThid = GetCurrentThreadId();

cJSON_AddNumberToObject(ids_json, "dllThid", dllThid); //必需

cJSON_AddStringToObject(ids_json, "more", NULL); //备用字段

//必须反馈验证

if (strcmp(cJSON_GetObjectItem(ids_json,"cid")->valuestring,mycid)==0 && strcmp(cJSON_GetObjectItem(ids_json,"AuthKey")->valuestring,"000")==0 && strcmp(cJSON_GetObjectItem(ids_json,"clsId")->valuestring,clsId)==0) {

//msg若反馈必须有 \"clsId\" \"AppAuth\"。AppAuth为1 clsId一致才继续 // 支持\" 或者 '

msg = joinStr("{\"data\":{\"code\":200,\"cid\":\"00000-1\",\"sid\":\"123\",\"rid\":-1,\"rec\":",msg,",\"AppStep\":\"init\"}}");

cJSON_AddNumberToObject(ids_json, "AppAuth", 1);

char *ids2=cJSON_PrintUnformatted(ids_json);

//必须反馈验证

AppDll_SendMsg(hwnd,ids2,msg);

}else{

cJSON_AddNumberToObject(ids_json, "AppAuth", 0);

char *ids2=cJSON_PrintUnformatted(ids_json);

// 反馈验证

AppDll_SendMsg(hwnd,ids2,NULL);

}

cJSON_Delete(ids_json);

return 0;

}

__declspec(dllexport) int AppDll_loaded(HWND hwnd, char *ids,char *msg)

{

//处理业务 //msg若反馈必须有data

// msg = joinStr("{\"data\":{\"code\":200,\"cid\":\"00000-1\",\"sid\":\"123\",\"rid\":-1,\"rec\":",msg,",\"AppStep\":\"loaded\"}}");

//若反馈则

AppDll_SendMsg(hwnd,ids,msg); //如果msg中没有data，则不反馈到浏览器中

return 0;

}

__declspec(dllexport) int AppDll_destroy(HWND hwnd, char *ids,char *msg)

{

//处理业务msg若反馈必须有 data

//msg = joinStr("{\"data\":{\"code\":200,\"cid\":\"00000-1\",\"sid\":\"123\",\"rid\":-1,\"rec\":",msg,",\"AppStep\":\"destroy\"}}");

//若反馈则

AppDll_SendMsg(hwnd,ids,msg);

return 0;

}

//测试

__declspec(dllexport) int Add(int a, int b )

{

return a+b;

}

__declspec(dllexport) int AppDll_init(HWND hwnd, char *ids,char *Json)

{

//判断获得AppEmit提供ids(格式json)里面cid sid pid Auth等数据

//和websocket的自行web提供的Json里面的data，判断验证来源是否正确

//msg若反馈必须有 \"AppStep\", \"clsId\" \"AppAuth\"。AppAuth为true clsId一致才继续

// 支持\" 或者 ' 如果有data，只发送data字段到浏览器websock接收

char *msg = joinStr(joinStr("{\"data\":{\"code\":200,\"cid\":\"00000-1\",\"sid\":\"123\",\"rid\":-1,\"rec\":",Json,",\"AppStep\":\"init\"},\"AppStep\":\"init\",\"AppAuth\":true,\"clsId\":\""),clsId,"\"}");

dllThid = GetCurrentThreadId();

//必须反馈验证

AppDll_OnMsg(hwnd,ids,msg);

return 0;

}

__declspec(dllexport) int AppDll_loaded(HWND hwnd, char *ids,char *Json)

{

//处理业务 //msg若反馈必须有 \"clsId\".如果有data，只发送data到浏览器websock接收

char *msg = joinStr(joinStr("{\"data\":{\"code\":200,\"cid\":\"00000-1\",\"sid\":\"123\",\"rid\":-1,\"rec\":",Json,",\"AppStep\":\"loaded\"},\"AppStep\":\"loaded\",\"clsId\":\""),clsId,"\"}");

//若反馈则OnMsg

AppDll_OnMsg(hwnd,ids,msg);

return 0;

}

__declspec(dllexport) int AppDll_destroy(HWND hwnd, char *ids,char *Json)

{

//处理业务msg若反馈必须有 \"clsId\" .如果有data，只发送data到浏览器websock接收

char *msg = joinStr(joinStr("{\"data\":{\"code\":200,\"cid\":\"00000-1\",\"sid\":\"123\",\"rid\":-1,\"rec\":",Json,",\"AppStep\":\"destroy\"},\"AppStep\":\"destroy\",\"clsId\":\""),clsId,"\"}");

//若反馈则OnMsg

AppDll_OnMsg(hwnd,ids,msg);

return 0;

}

//测试

__declspec(dllexport) int Add(int a, int b )

{

return a+b;

}

1. 1. 调用

主要有两种方法来实现。

通过AppEmit来调用DLL互动信息，有些ActiveX可以免注册。
通过打开IE内核，来createObject调用ActiveX ,需要注册ActiveX

下面使用AppEmit来调用DLL互动信息

生成dll_demodll后，安装在/plugins/private/Pid/下面

/plugins/private/50FCF891-1B93-4AE5-8A66-AB26A3C03378/dll_demo1.dll"

就能在能在网页中执行命令，调用互动dll_demo1,举例见demo/htmlDemo/dll.html

可以在dllJs.html进一步设置参数AppType==3情况，在dllJs.html中也可以设置src参数和过程,调用代码。

同时也能通过浏览器网页发布命令runCmd,执行AppDll_RevMsg方法。

codeStr= txt2code(function(){/*

AppJsObject.dll_demo1.AppDll_RevMsg(AppDll_hwnd,'','{"data":"send from JS","info":3}');

* /});

var Req={"emit":"runCmd","Obj":"dll","codeStr":codeStr }

EmitReq(Req);

1. 1. 1. 嵌入网页JS控制

AppJs_init=function(AppType)

如果在浏览器网页中没有设置src，可以在这里设置。

src:[ {

// webJs0:0, //只能设置为0 关闭本js的控制 ; 或者注释为默认打开控制

createType:"createDll" // dll调用

,objName:"dll_demo1"

,dllFile:"/plugins/private/50FCF891-1B93-4AE5-8A66-AB26A3C03378/dll_demo1.dll" // 必须 \\ / 放在/plugins/private/clsId/文件夹下面

,clsId :"50FCF891-1B93-4AE5-8A66-AB26A3C03378" //guid 发送给dll 信息

,iid:null

,data:'{"msg":"init from JS","info":1}' //发送给dll 数据

} //暂时支持一个控件

]

,AppShow:false //整体不可见必须设置，默认可见

AppJs_loaded=function(AppType){

//系统启动APP ,产生AppJsObject. shockwave对象后执行

AppJsObject.dll_demo1.AppDll_loaded(AppDll_hwnd, "",{"msg":"loaded from JS","info":2}');

AppJs_destroy=function(){ //AppJsObject.shockwave销毁前执行

AppJsObject.dll_demo1.AppDll_destroy(AppDll_hwnd, "",{"msg":"destroy from JS","info":3}');

AppJs_closed=function(status){ //AppJsObject.shockwave关闭后执行。已经没有AppJsObject.shockwave对象了

1. 1. 1. 浏览器网页执行代码命令控制

AppJsObject.dll_demo1

Var Req={"emit":"runCmd","Obj":"dll","codeStr": codeStr}

EmitReq(Req);

通过前面dllJs.html定义的AppJsObject.dll_demo1，可以直接控制dll_demo1。当然也可以不需要dllJs.html定义，能在浏览器网页中websocket发送使用"emit":"runCmd"命令发送AppJs_init、AppJs_loaded，代码也可以。

参数
1. 连接

ws://localhost:80/appemit?cid=00000-1&sid=1&flag=1

名称	设置	含义	说明
协议	ws	SSL为wss
网址	Localhost 127.0.0.1
port	[80,8617,8618,8619,9780]	数值或者数组，默认80。	依次尝试打开端口。若所有端口被占用尝试关闭最后一个port的进程，打开最后一个端口都可以在config.in修改
	[443,5124,5125,5126,43100]	ssl默认443。	同上。
path	appemit	必需
para	cid	必需。00000-1为免费账号。	全集。
	sid	字符串，通常情况可选。唯一session或者用户名ID	测试后最好在js中实现隐藏。如果需要调用私有APP，则必须有，否则无法互相通话。
	flag	可选。默认0，非调试。 1调试

1. 初始化数据

{"emit":"init",…}

var AE_initSet = {

"emit":"init",

"clientKey": "temp-0000000000", //

"clientInfo":clientInfo,

"wsUrl": wsUrl,

// "flag":0,

// "sid":"123456", // 用户session 或者用户名ID，唯一可以准确通话

"gid": "[1,2]", //用户群ID，一个用户可以加入多个群

// "utf_escape":false, //默认false, 反馈的data编码转义

};

名称	设置	含义	说明
emit	init	必需。初始化请求。
clientKey	temp-0000000000	必需, 客户端，与cid对应。	保密，js应该混淆加密。
clientInfo	对象	必需。使用浏览器。默认
wsUrl	wsUrl	必需。默认	可以在config.in修改
sid	字母数字下划线短线	必需。用户或者session，唯一才可以正常通话。	生产环境，同一设置于此。
gid	数组	非必需。群	一个sid可有不同gid
utf_escape	false	默认false	反馈的data编码转义

1. 命令

说明，参数分组为{a,par:{b},par0:{c}}

abc里面的字段名称都要不同。

参数形式如下

名称	设置	含义	说明
emit		init 初始化 open 打开App runCmd 互动调用App运行命令 close\|closeAll 关闭App msg 发送消息 hardware 获取硬件信息
Obj		pc
AppId	1	1,2,3	一个页面一个APP，默认为1。
AppType	1，-1	1,2,3,4… -1,-2,-3,-4	正数嵌入负数浮动
pos	1，-1 [left,top,width,height]	位置 1 更新位置 -1 删除位置数据 [left,top,width,height] 保留
data
src
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
AppStatus	1/0	系统自动反馈 1打开 0关闭	接收的数据
par		必填参数
objName
…
par0		可填参数
header
userAgent
crossDomain
…

1. 1. 硬件
    1. 硬件信息

{"emit":"hardWare","Obj":"pc","par0":{"dev":["device","os","display","cpu","net","memory","storage","base"]}}

名称	设置	含义	说明
emit	hardWare	必需。通信请求。
Obj	pc	必需。目标对象。
par0
dev	字符串 "base" 或者数组["device"]	非必需 ["device","os","display","cpu","net","memory","storage","base"]，取某个值都即可。为空时默认设置为"base"	"base"可获取多个设备,但是对于windows精简版本可能无法获取信息。其它字段获取为第一个设备。免费版本仅支持"base"
rid	整数	必需。表示本次具体请求标号。	如果没有设置，则每次发送命令自动加1。后续省略描述。

1. 1. 1. 串口
      1. 串口控件Pcomm

在网页中调用Pcomm.dll的串口控件，支持多窗口同时异步跨线程调用串口。

{"emit":"open","Obj":"comm","AppType":1,"AppShow":true,"pos":1,"par":{"objName":"Pcomm1","Port":"com1","BaudRate":"9600","ByteSize":"8","Parity":"none","StopBits":"1"},"par0":{"AppMethod":"POST","Send_AsciiHex":"Ascii","Resv_AsciiHex":"Ascii","BaudRate_list":["50","75","110","134","150","300","600","1200","1800","2400","4800","7200","9600","19200","38400","57600","115200","230400","460800","921600"],"ByteSize_list":["5","6","7","8"],"Parity_list":["none","even","odd","spc","mrk"],"StopBits_list":["1","1.5","2"]}}

名称	设置	含义	说明
emit	open	必需。打开串口事件请求。
Obj	comm	必需。
AppId	键值	必需。未定义时默认为AppId	一个页面打开多个应用，应用的AppId必须不同。
AppType	1	必需。 1 Pcomm 2 comm	有默认的右键菜单。若为负数-1,则是浮动窗口
pos	1	0无界面不需要 1 有界面，位置自动识别
data		非必需。	启动后发送给串口的数据
AppShow	false	必需。空时默认窗口不可见。有界面必需设置true。
AppStatus	1/0	系统自动反馈 1打开 0关闭	接收的数据
par
objName	字符串	字符串变量，字母开头、数字、下划线、	用来在js调用变量
Port	com1/1
par0
BaudRate	9600
ByteSize	8
Parity	none
StopBits	1
codePage	65001	65001 utf8 1200 UCS-2LE 1201 UCS-2BE 0 不处理	反馈的数据编码，默认65001
backNoJson	true/false	默认false,反馈为json true,调用的dll或者ocx反馈的数据直接发送，不处理编码或者json转换	反馈的数据处理

1. 1. 1. 1. 串口控件mscommm32

commm32功能低，暂时未测试。

在网页中调用commm32.ocx的串口控件

{"emit":"open","Obj":"comm","pos":1,"par":{},"data":"1111","par0":{"codePage":65001,"multiThread":1,"backNoJson":0}}

名称	设置	含义	说明
emit	open	必需。打开串口事件请求。
Obj	comm	必需。
AppType	2	必需。 1 Pcomm 2 comm	有默认的右键菜单。若为负数-1,则是浮动窗口
pos	0	无界面不需要
data		非必需。	启动后发送给串口的数据
AppShow	true/false	默认窗口不可见。有界面必需设置true。
par
par0
attach	1	附着APP方式		wps最好采用此方式. 如果程序出现未知错误，可采用此方式
codePage	65001	65001 utf8 1200 UCS-2LE 1201 UCS-2BE 0 不处理	反馈的数据编码，默认65001
backNoJson	true/false	默认false,反馈为json true,调用的dll或者ocx反馈的数据直接发送，不处理编码或者json转换	反馈的数据处理

发送数据

名称	设置	含义	说明
emit	send	必需。打开串口事件请求。
Obj	comm	必需。
AppType	1	必需。 comm	有默认的右键菜单。若为负数-1,则是浮动窗口
data		必需。	发送给串口的数据

1. 1. 1. USB Hid通信接口信息

{"emit":"hid"}

名称	设置	含义	说明
emit	hid	必需。获得hid通信接口信息。

1. 1. 1. 热拔事件

{"emit":"deviceNotification","driveType":2}

名称

设置

含义

说明

emit

deviceNotification

必需。监控热拔请求。

driveType

数值或者数组2 ，

[1,2]，

-1

-1 关闭监控

1 DRIVE_NO_ROOT_DIR 说明无效的

2 DRIVE_REMOVABLE可移动磁盘

3 DRIVE_FIXED 固定磁盘

4 DRIVE_REMOTE 网络磁盘

5 DRIVE_CDROM 光驱

6 DRIVE_RAMDISK 为RAM磁盘

1. 1. 通话

{"emit":"msg", "Obj":"sid","toSids":["2"],"toGids":[1,2],"data":"hi, I am Tom."}

名称	设置	含义	说明
emit	msg	必需。通信事件请求。
Obj	sid	用户自行设定的sid
toSids	必需要有一个	非必需。可以是数组。	All sids=cid, self_sid emit msg to(distinct (toSids ∪ toSids)-self_sid) 发送的全集是：发送的用户和发送所在的群（频道、小组）的用户的全集剔重后，排除自身
toGids	必需要有一个	非必需。可以是数组。
data		必需。

1. 1. APP事件

参数格式如下

名称	设置	含义	说明
emit	open	必需。打开控件APP通信事件请求。
Obj		必需。 flash默认 word 后续支持 excel后续支持 CAD后续支持
AppType	±1±2±3±4	正数表示嵌入负数浮动窗口在Obj不同时，AppType的含义不一样。	当AppType负数浮动窗口时，默认APP为置顶。取消置顶 {"emit":"setPar","Obj":"flash","topMost":false}
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
par0			注意不同APP可能不同
attach	1	附着APP方式	wps最好采用此方式. 如果程序出现未知错误，可采用此方式
header		头部

userAgent		代理	只写属性，不可读。
crossDomain	bool	默认true Ture false	是否跨域
rightMenu	右键菜单	-1 不处理，控件原有状态 0/null禁用菜单 1自定义简单菜单
show_UpdateTool	显示下载插件等待窗口	默认true false 不显示	需要下载更新包显示。可以直接在 https://github.com/appemit/appemit/plugins下载全集的插件

1. 1. 1. 打开文件

以系统默认的程序，打开文件。

为了安全，不支持直接打开的文件类型包括

"exe";"msi";"cmd";"js";"jar";"inf";"com";"scr";"reg";"bat";"vbs";"py"

发送命令打开文件，以独立的方式打开，和浏览器进程独立，没有联系。

{"emit":"open", "Obj":"file","AppShow":false,"src":["/demo/htmlDemo/file/d1.docx",null]}

src：EXE文件路径, 启动参数="",操作类型 = "open",显示属性 _SW_,工作目录=""

名称	设置	含义	说明
emit	open	必需。打开控件APP通信事件请求。
Obj	file	必需。
AppId	1	必需。
src		必需。	[file,参数,startInfo]
pos	-1
AppShow	false	必需。	不发送pos位置等数据
par0
UWP	1、0、null	null 默认。以传统方式打开可执行文件，若失败尝试UWP文件打开 0只以传统方式打开可执行文件 1 只打开UWP文件

1. 1. 1. "AppType":1打开flash网页webkit内核

{"emit":"open","Obj":"flash","AppType":1,"src":"http://sxiao.4399.com/4399swf/upload_swf/ftp14/yzg/20140328/bombit7/zx_game7.htm","pos":1,"par0":{"header":null,"userAgent":null,"crossDomain":true}}

名称	设置	含义	说明
emit	open	必需。打开控件APP通信事件请求。
Obj	flash	必需。
AppType	1	必需。 0 ActiveX 1 web 2 web flash文件 3 web媒体文件	若为负数-1,则是浮动窗口
src		必需。	AppType为0时支持本地文件，可以是相对或者绝对路径。
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。	对不同的浏览器，自动识别的位置需要优化
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
Par0		可选。
header		头部
userAgent		代理	只写属性，不可读。
crossDomain	bool	默认true Ture false	是否跨域
show_UpdateTool	0	在配置文件设置默认值 0 1显示更新文件下载窗口 0不显示

1. 1. 1. "AppType":2打开网络flash

名称	设置	含义	说明
emit	open	必需。打开控件APP通信事件请求。
Obj	flash	必需。
AppType	2	必需。 0 ActiveX 1 web 2 web flash文件 3 web媒体文件	使用webkit内核打开，没有默认的右键菜单。若为负数-2,则是浮动窗口
src		必需。	AppType为0时支持本地文件，可以是相对或者绝对路径。
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。	对不同的浏览器，自动识别的位置需要优化
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
par0	autoPlay	可选。默认true	参考flash官方默认参数。
	loop	可选。默认true	参考flash官方默认参数。
	quality	可选。默认high	参考flash官方默认参数。
	wmode	可选。默认Transparent	参考flash官方默认参数。
header		头部
userAgent		代理	只写属性，不可读。
crossDomain	bool	默认true Ture false	是否跨域
show_UpdateTool	0	在配置文件设置默认值 0 1显示更新文件下载窗口 0不显示

1. 1. 1. "AppType":3打开flash等媒体文件

{"emit":"open","Obj":"flash","AppType":3,"src":"https://cdn.jsdelivr.net/gh/appemit/appemit/docs/vedio/x1.flv","pos":1,"par0":{"autoPlay":1,"loop":1,"header":null,"userAgent":null,"crossDomain":true}}

名称	设置	含义	说明
emit	open	必需。打开控件APP通信事件请求。
Obj	flash	必需。
AppType	3	必需。 0 ActiveX 1 web 2 web flash文件 3 web媒体文件	若为负数-3,则是浮动窗口
src		必需。	AppType为0时支持本地文件，可以是相对或者绝对路径。
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。	对不同的浏览器，自动识别的位置需要优化
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
Par0	autoPlay	可选。默认1	参考 https://player.alicdn.com/aliplayer/setting/setting.html
	loop	可选。默认1
header		头部
userAgent		代理	只写属性，不可读。
crossDomain	bool	默认true Ture false	是否跨域
show_UpdateTool	0	在配置文件设置默认值 0 1显示更新文件下载窗口 0不显示

1. 1. 1. "AppType":4打开flash文件

名称	设置	含义	说明
emit	open	必需。打开控件APP通信事件请求。
Obj	flash	必需。 flash默认 word 后续支持 excel后续支持 CAD后续支持
AppType	4	必需。 4 ActiveX 1 web 2 web flash文件 3 web媒体文件	设为4时，如何本地没有安装ActiveX则默认使用方式2打开若为负数-4,则是浮动窗口
src		必需。	AppType为0时支持本地文件，可以是相对或者绝对路径。
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
par0	autoPlay	可选。 0 不自动播放 1自动播放，默认
	toolbar	可选。 0 没有控制条，默认 1 有控制条
	rightMenu	可选。 0 1
	hitCaption	可选。 0 左按鼠标不能拖动，默认 1 左按鼠标能拖动
	hideStop	可选。 0 隐藏不见时不停止播放，默认 1隐藏不见时停止播放
	loop	可选。 0 不自动循环播放， 1 循环播放，默认
	volumeMute	可选。 0 不静音，默认 1 静音
	flashVars	可选。	可以设置在src里面
show_UpdateTool	0	在配置文件设置默认值 0 1显示更新文件下载窗口 0不显示

1. 1. 1. IE内核打开网页

{"emit":"open","Obj":"web","AppType":1,"pos":1,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"http://www.appemit.com"},"par0":{"header":null,"noScriptErr":true,"UIFLAG":null,"DLCTL":null,"userAgent":null,"crossDomain":true,"rightMenu":null}}

名称	设置	含义	说明
emit	open	必需。打开网页事件请求。
Obj	web	必需。
AppType	1	必需。 1 IE内核 2 webkit内核 3 blink 内核	有默认的右键菜单。若为负数-1,则是浮动窗口
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。	对不同的浏览器，自动识别的位置需要优化
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
par		必需。优先级别依次下降	三个参数必须有一个不是空。
htmlStr		Html代码
HttpServer_startUrl		以服务器形式打开本地html文件路径，可以是绝对或者相对路径。/为分隔符。
URL	http://www.appemit.com 或者 /demo/htmlDemo/html.html	支持网页地址或者本地html文件路径。
Par0		可选。
emulation	若不指定，默认最新的IE兼容版本	11001 页面始终以 IE11 模式显示，而不考虑指令 11000 包含基于标准的指令的页面将以 IE11 模式显示 10001 页面始终以 IE10 模式显示，而不考虑指令 10000 包含基于标准的指令的页面将以 IE10 模式显示 9999 页面始终以 IE9 模式显示，而不考虑指令 9000 包含基于标准的指令的页面将以 IE9 模式显示 8888 页面始终以 IE8 模式显示，而不考虑指令 8000 包含基于标准的指令的页面将以 IE8 模式显示 7000 包含基于标准的指令的页面将以 IE7 模式显示	参考 https://www.csdn.net/article/2012-10-22/2811049
noScriptErr	bool	默认true Ture false
UIFLAG		_UIFLAG_DIALOG=@0x1/_UIFLAG_DIALOG/ _UIFLAG_DISABLE_HELP_MENU=@0x2/_UIFLAG_DISABLE_HELP_MENU/ _UIFLAG_NO3DBORDER=@0x4/_UIFLAG_NO3DBORDER/ _UIFLAG_SCROLL_NO=@0x8/_UIFLAG_SCROLL_NO/ _UIFLAG_DISABLE_SCRIPT_INACTIVE=@0x10/_UIFLAG_DISABLE_SCRIPT_INACTIVE/ _UIFLAG_OPENNEWWIN=@0x20/_UIFLAG_OPENNEWWIN/ _UIFLAG_DISABLE_OFFSCREEN=@0x40/_UIFLAG_DISABLE_OFFSCREEN/ _UIFLAG_FLAT_SCROLLBAR=@0x80/_UIFLAG_FLAT_SCROLLBAR/ _UIFLAG_DIV_BLOCKDEFAULT=@0x100/_UIFLAG_DIV_BLOCKDEFAULT/ _UIFLAG_ACTIVATE_CLIENTHIT_ONLY=@0x200/_UIFLAG_ACTIVATE_CLIENTHIT_ONLY/ _UIFLAG_OVERRIDEBEHAVIORFACTORY=@0x400/_UIFLAG_OVERRIDEBEHAVIORFACTORY/ _UIFLAG_CODEPAGELINKEDFONTS=@0x800/_UIFLAG_CODEPAGELINKEDFONTS/ _UIFLAG_URL_ENCODING_DISABLE_UTF8=@0x1000/_UIFLAG_URL_ENCODING_DISABLE_UTF8/ _UIFLAG_URL_ENCODING_ENABLE_UTF8=@0x2000/_UIFLAG_URL_ENCODING_ENABLE_UTF8/ _UIFLAG_ENABLE_FORMS_AUTOCOMPLETE=@0x4000/_UIFLAG_ENABLE_FORMS_AUTOCOMPLETE/ _UIFLAG_ENABLE_INPLACE_NAVIGATION=@0x10000/_UIFLAG_ENABLE_INPLACE_NAVIGATION/ _UIFLAG_IME_ENABLE_RECONVERSION=@0x20000/_UIFLAG_IME_ENABLE_RECONVERSION/ _UIFLAG_THEME=@0x40000/_UIFLAG_THEME/ _UIFLAG_NOTHEME=@0x80000/_UIFLAG_NOTHEME/ _UIFLAG_NOPICS=@0x100000/_UIFLAG_NOPICS/ _UIFLAG_NO3DOUTERBORDER=@0x200000/_UIFLAG_NO3DOUTERBORDER/ _UIFLAG_DISABLE_EDIT_NS_FIXUP=@0x400000/_UIFLAG_DISABLE_EDIT_NS_FIXUP/ _UIFLAG_LOCAL_MACHINE_ACCESS_CHECK=@0x800000/_UIFLAG_LOCAL_MACHINE_ACCESS_CHECK/ _UIFLAG_DISABLE_UNTRUSTEDPROTOCOL=@0x1000000/_UIFLAG_DISABLE_UNTRUSTEDPROTOCOL/ _UIFLAG_HOST_NAVIGATES=@0x2000000/_UIFLAG_HOST_NAVIGATES/ _UIFLAG_ENABLE_REDIRECT_NOTIFICATION=@0x4000000/_UIFLAG_ENABLE_REDIRECT_NOTIFICATION/ _UIFLAG_USE_WINDOWLESS_SELECTCONTROL=@0x8000000/_UIFLAG_USE_WINDOWLESS_SELECTCONTROL/ _UIFLAG_USE_WINDOWED_SELECTCONTROL=@0x10000000/_UIFLAG_USE_WINDOWED_SELECTCONTROL/ _UIFLAG_ENABLE_ACTIVEX_INACTIVATE_MODE=@0x20000000/_UIFLAG_ENABLE_ACTIVEX_INACTIVATE_MODE/ _UIFLAG_DPI_AWARE=@0x40000000/_UIFLAG_DPI_AWARE/	可以使用一个或多个_UIFLAG_ 前缀的常量自定义外观,多个常量之间用位或操作符( \| ) 连接。 LOG 禁止选中文本( 用于 web ui ) _UIFLAG_SCROLL_NO 禁用滚动条 _UIFLAG_NO3DBORDER 禁用所有窗口3D边框 _FLAG_NO3DOUTERBORDER 禁用顶层窗口3D边框 _UIFLAG_DISABLE_HELP_MENU 在菜单中移除帮助菜单 _UIFLAG_DISABLE_SCRIPT_INACTIVE 窗口激活以前不运行网页脚本 _UIFLAG_OPENNEWWIN 在新窗口打开链接 _UIFLAG_FLAT_SCROLLBAR 显示平面滚动条 _UIFLAG_ACTIVATE_CLIENTHIT_ONLY 仅在用户点击客户区时激活(非客户区指滚动条等位置) _UIFLAG_URL_ENCODING_DISABLE_UTF8 禁用UTF8发送URL _UIFLAG_URL_ENCODING_ENABLE_UTF8 使用UTF8发送URL _UIFLAG_ENABLE_FORMS_AUTOCOMPLETE 允许表单自动完成 _UIFLAG_ENABLE_INPLACE_NAVIGATION 在点击邮件等链接时，打开相关应用程序，而不是新开窗口 _UIFLAG_NOTHEME 使用主题 _UIFLAG_THEME 禁用主题 _UIFLAG_NOPICS 禁用内容分级 _UIFLAG_DIV_BLOCKDEFAULT 编辑模式回车输入div _UIFLAG_DISABLE_EDIT_NS_FIXUP 编辑模式禁用名字空间修正 _UIFLAG_LOCAL_MACHINE_ACCESS_CHECK 防止远程网页导航到本地计算机 _UIFLAG_DISABLE_UNTRUSTEDPROTOCOL 禁止非信任协议,包含 ms-its, ms-itss, its,mk:@msitstore
DLCTL		_DLCTL_DLIMAGES=@0x10/_DLCTL_DLIMAGES/ _DLCTL_VIDEOS=@0x20/_DLCTL_VIDEOS/ _DLCTL_BGSOUNDS=@0x40/_DLCTL_BGSOUNDS/ _DLCTL_NO_SCRIPTS=@0x80/_DLCTL_NO_SCRIPTS/ _DLCTL_NO_JAVA=@0x100/_DLCTL_NO_JAVA/ _DLCTL_NO_RUNACTIVEXCTLS=@0x200/_DLCTL_NO_RUNACTIVEXCTLS/ _DLCTL_NO_DLACTIVEXCTLS=@0x400/_DLCTL_NO_DLACTIVEXCTLS/ _DLCTL_DOWNLOADONLY=@0x800/_DLCTL_DOWNLOADONLY/ _DLCTL_NO_FRAMEDOWNLOAD=@0x1000/_DLCTL_NO_FRAMEDOWNLOAD/ _DLCTL_RESYNCHRONIZE=@0x2000/_DLCTL_RESYNCHRONIZE/ _DLCTL_PRAGMA_NO_CACHE=@0x4000/_DLCTL_PRAGMA_NO_CACHE/ _DLCTL_NO_BEHAVIORS=@0x8000/_DLCTL_NO_BEHAVIORS/ _DLCTL_NO_METACHARSET=@0x10000/_DLCTL_NO_METACHARSET/ _DLCTL_URL_ENCODING_DISABLE_UTF8=@0x20000/_DLCTL_URL_ENCODING_DISABLE_UTF8/ _DLCTL_URL_ENCODING_ENABLE_UTF8=@0x40000/_DLCTL_URL_ENCODING_ENABLE_UTF8/ _DLCTL_NOFRAMES=@0x80000/_DLCTL_NOFRAMES/ _DLCTL_FORCEOFFLINE=@0x10000000/_DLCTL_FORCEOFFLINE/ _DLCTL_NO_CLIENTPULL=@0x20000000/_DLCTL_NO_CLIENTPULL/ _DLCTL_SILENT=@0x40000000/_DLCTL_SILENT/ _DLCTL_OFFLINEIFNOTCONNECTED=@0x80000000/_DLCTL_OFFLINEIFNOTCONNECTED/ _DLCTL_OFFLINE=@0x80000000/_DLCTL_OFFLINE/	DLCTL_前缀的常量以控制下载行为,多个常量之间用位或操作符( \| ) 连接。 _DLCTL_DLIMAGES 允许从服务器下载图片,如果指定了第三个参数,未指定此标志,则网页不下载任何图片. _DLCTL_VIDEOS 允许从服务器下载视频片断,如果指定了第三个参数,未指定此标志,则网页不下载任何视频片断. _DLCTL_BGSOUNDS 允许播放文档指定的背景声音 _DLCTL_NO_SCRIPTS web窗体不执行任何页面脚本(指javascript等) _DLCTL_NO_JAVA web窗体不执行任何 Java applet _DLCTL_NO_RUNACTIVEXCTLS web窗体不执行文档中的任何 ActiveX 控件； _DLCTL_NO_DLACTIVEXCTLS web窗体不下载文档中的任何 ActiveX 控件； _DLCTL_DOWNLOADONLY web窗体下载网页,但不显示 _DLCTL_NO_FRAMEDOWNLOAD web窗体对包含框架的页面进行语法分析但不下载任何帧，同时忽略框架， _DLCTL_RESYNCHRONIZE web窗体忽略缓存中的数据并向服务器请求更新 _DLCTL_PRAGMA_NO_CACHE 迫使请求发送给服务器并忽略代理(这里一般指服务端缓存)，即使代理指明数据是最新的也是如此. _DLCTL_NO_METACHARSET 隐藏文档中的 META 元素指示的字符集； _DLCTL_URL_ENCODING_DISABLE_UTF8 禁止 UTF-8 编码 _DLCTL_URL_ENCODING_ENABLE_UTF8 允许 UTF-8 编码 _DLCTL_NOFRAMES 禁止框架 _DLCTL_FORCEOFFLINE web窗体工作在脱机方式 _DLCTL_NO_CLIENTPULL web窗体不执行任何客户端的 pull 操作 _DLCTL_SILENT 组件对话框、脚本错误对话框静默模式 _DLCTL_OFFLINEIFNOTCONNECTED 如果未连接互联网，浏览器组件将以脱机方式工作
header		头部
userAgent		代理	默认null
crossDomain	bool	默认true Ture false
rightMenu	右键菜单	-1 不处理，控件原有状态 0/null禁用菜单 1自定义简单菜单	各个含义不同，请注意。-1 不处理。默认有详细菜单。通常需要使用flash右键使用此值。对于flash右键功能请测试。
show_UpdateTool	0	在配置文件设置默认值 0 1显示更新文件下载窗口 0不显示

1. 1. 1. webkit内核打开网页

名称	设置	含义	说明
emit	open	必需。打开网页事件请求。
Obj	web	必需。
AppType	2	必需。 1 IE内核 2 webkit内核 3 blink 内核	有默认的右键菜单。若为负数-2,则是浮动窗口
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。	对不同的浏览器，自动识别的位置需要优化
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
par		必需。优先级别依次下降	三个参数必须有一个不是空。
htmlStr		Html代码
HttpServer_startUrl		以服务器形式打开本地html文件路径，可以是绝对或者相对路径。/为分隔符。
URL	http://www.appemit.com 或者 /demo/htmlDemo/html.html	支持网页地址或者本地html文件路径。
Par0		可选。
header		头部
userAgent		代理	只写属性，不可读。
crossDomain	bool	默认true Ture false	是否跨域
rightMenu	右键菜单	-1 不处理，控件原有状态 0/null禁用菜单 1自定义简单菜单	各个含义不同，请注意。-1 不处理。默认没有菜单。通常需要使用flash右键使用此值。对于flash右键功能请测试。
show_UpdateTool	0	在配置文件设置默认值 0 1显示更新文件下载窗口 0不显示
downLoad	1	默认true true false	支持连接下载功能

1. 1. 1. blink内核打开网页

名称	设置	含义	说明
emit	open	必需。打开网页事件请求。
Obj	web	必需。
AppType	3	必需。 1 IE内核 2 webkit内核 3 blink 内核	有默认的右键菜单。若为负数-3,则是浮动窗口
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。	对不同的浏览器，自动识别的位置需要优化
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
par		必需。优先级别依次下降	三个参数必须有一个不是空。
htmlStr		Html代码
HttpServer_startUrl		以服务器形式打开本地html文件路径，可以是绝对或者相对路径。/为分隔符。
URL	http://www.appemit.com 或者 /demo/htmlDemo/html.html	支持网页地址或者本地html文件路径。
Par0		可选。
header		头部
userAgent		代理	可读写。默认 Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3729.169 Safari/537.36
crossDomain	bool	默认true true false
rightMenu	右键菜单	-1 不处理，控件原有状态 0/null禁用菜单 1自定义简单菜单	各个含义不同，请注意。-1 不处理。默认有菜单。通常需要使用flash右键使用此值。对于flash右键功能请测试。
show_UpdateTool	0	在配置文件设置默认值 0 1显示更新文件下载窗口 0不显示
downLoad	1	默认true true false	支持连接下载功能

1. 1. 1. 打开PDF文件

打开阅读PDF文件，支持本地和网络PDF

{"emit":"open","Obj":"web","AppType":4,"pos":1,"par":{"URL":" https://cdn.jsdelivr.net/gh/appemit/AppEmitWeb@master/docs/demo/AppEmit_help.pdf "},"par0":{"rightMenu":1}}

名称	设置	含义	说明
emit	open	必需。打开PDF事件请求。
Obj	web	必需。
AppType	4	必需。 1 IE内核 2 webkit内核 3 blink 内核 4 PDF 文件	有默认的右键菜单。若为负数-4,则是浮动窗口
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。	对不同的浏览器，自动识别的位置需要优化
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
par		必需。
URL	https://cdn.jsdelivr.net/gh/appemit/AppEmitWeb@master/docs/demo/AppEmit_help.pdf 或者 /demo/AppEmit_help.pdf	支持网页pdf地址,或本地文件绝对或相对路径。
Par0		可选。
rightMenu	右键菜单	-1 不处理，控件原有状态 0/null禁用菜单 1自定义简单菜单	各个含义不同，请注意。
rightMenu	右键菜单	-1 不处理，控件原有状态 0/null禁用菜单 1自定义简单菜单	各个含义不同，请注意。-1 不处理。默认有菜单。通常需要使用flash右键使用此值。对于flash右键功能请测试。
show_UpdateTool	0	在配置文件设置默认值 0 1显示更新文件下载窗口 0不显示

1. 1. 1. Office

创建、打开阅读、编辑Office文件，支持本地和网络文件, 包括word\excel\PPT文件

更多VBA官方参考https://docs.microsoft.com/zh-cn/office/vba/api/overview/word

或者录制宏，编辑参考代码。

1. 1. 1. 1. msOffice

{"emit":"open","Obj":"office","AppType":1,"src":"/demo/htmlDemo/file/d1.docx","pos":1,"par0":{"Titlebar":0,"ProtectDoc":0,"Menubar":0,"Toolbars":0,"btnFile":0,"HttpPost":{"URL":"http://eu.httpbin.org/post","valid":0,"fileName":"s1.docx"},"MNU_NEWBLANK":0,"MNU_NEW":0,"MNU_OPEN":0,"MNU_CLOSE":0,"MNU_SAVE":0,"MNU_SAVEAS":0,"MNU_PGSETUP":0,"MNU_PRINT":0,"MNU_PROPS":0,"show_UpdateTool":true}}

名称	设置	含义	说明
emit	open	必需。打开office事件请求。
Obj	office	必需。
AppType	1	必需。 word excel powerpoint	有默认的右键菜单。若为负数-1,则是浮动窗口对于特殊wps，通常采用attach方式打开。
src	字符串； path为 [path, openPar]	path为必需, 字符串网址或者本地相对或者绝对路径 ,或者数组（防止网页src里面没有文件名称或者后缀名称需要修改，则使用fileType ）。 openPar: 具体不同。 "/demo/htmlDemo/file/x1.xls" ["/demo/htmlDemo/file/x1.xls" ,openPar] [[http://.../demo/htmlDemo/file/x1.xls,"x2.xlsx"],openPar]	Word系列文件 Excel系列文件 PPT系列文件不同应用的openPar不同，详细见后
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。	对不同的浏览器，自动识别的位置需要优化
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
Par0		可选。
progId	[]	默认为MS office ["Word.Application","Kwps.Application","WPS.Application"] ["Excel.Application","Ket.Application","ET.Application"] ["PowerPoint.Application","WPP.Application"]	采用不同自动化服务器打开文档、表格、幻灯片，按顺序依次尝试。默认打开微软office\金山wps
attach	1	附着APP方式	wps最好采用此方式. 如果程序出现未知错误，可采用此方式
noMinMax	1	1 禁用关闭最小最大化按钮 0/null 可最大小化关闭	遮盖关闭最小最大化按钮
openPar			不同应用不一样，详细见后
Titlebar	0	默认 0不显示标题栏 1 显示标题栏 0 不显示
Menubar	1	默认 1显示菜单栏 1 显示标题栏 0 不显示
Statusbar	1	默认 1显示状态栏 1 显示状态栏 0 不显示
Protect	1		不同应用不一样，详细见后
Toolbars	1	默认 1 ，显示工具栏 1 显示 0 不显示	需要手动点击
btnFile	1	工具栏的文件File按钮 1 /true 默认显示 0	Toolbars为真时有效
ViewType	1		不同应用不一样，详细见后
HttpPost	{"URL":"url", "valid":1, "method":"POST" "username":"name" "username":"*" "cookie":null}	URL上传的地址，必需 method 上传的方法POST\GET,默认POST cookie	如果上传，URL必需,valid=1设为有效。
header		头部	以下参数用于下载上传使用
userAgent		代理	默认null
cookies
proxy
proxyBypass
flags
crossDomain	bool	默认true Ture false
MNU_UPLOAD	0	默认 0 ，工具栏上传命令菜单 1 显示上传提交 0 不显示	Toolbars、btnFile、HttpPost["URL"] 同时为真时有效
MNU_NEWBLANK	0	默认 0 ，工具栏FILE命令菜单 1 显示新建空白 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_NEW	0	默认 0 ，工具栏FILE命令菜单 1 显示新建 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_OPEN	0	默认 0 ，工具栏FILE命令菜单 1 显示打开 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_CLOSE	0	默认 0 ，工具栏FILE命令菜单 1 显示关闭 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_SAVE	0	默认 0 ，工具栏FILE命令菜单 1 显示保存 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_SAVEAS	0	默认 0 ，工具栏FILE命令菜单 1 显示另存 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_PGSETUP	0	默认 0 ，工具栏FILE命令菜单 1 显示页面设置 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_PRINT	0	默认 0 ，工具栏FILE命令菜单 1 显示打印 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_PROPS	0	默认 0 ，工具栏FILE命令菜单 1 显示属性 0 不显示	Toolbars、btnFile 同时为真时有效
show_UpdateTool	0	在配置文件设置默认值 0 1显示更新文件下载窗口 0不显示

1. 1. 1. 1. Word 其它参数

更多https://docs.microsoft.com/zh-cn/office/vba/api/overview/word

名称	设置	含义	说明
Par0		可选。
src	[path,0,1,0]	ConfirmConversions=false, _ ReadOnly=false, AddToRecentFiles=false, PasswordDocument="", _ PasswordTemplate="", Revert=false, WritePasswordDocument="", _ WritePasswordTemplate="", Format=wdOpenFormatAuto, XMLTransform=""	按顺序
ViewType	1	wdMasterView 5 主控视图。 wdNormalView 1 普通视图。 wdOutlineView 2 大纲视图。 wdPrintPreview 4 打印预览视图。 wdPrintView 3 页面视图。 wdReadingView 7 阅读视图。 wdWebView 6 Web 视图。
Protect	[Type,NoReset,Password,UseIRM, EnforceStyleLock]	Type必需 wdAllowOnlyComments=1只允许将批注添加到文档中。 wdAllowOnlyFormFields=2只允许通过窗体域将内容添加到文档中。 wdAllowOnlyReading=3 允许对文档进行只读访问。 wdAllowOnlyRevisions=0只允许对现有内容进行修订。 wdNoProtection=-1 不对文档应用保护。	更改为自行在officeJs中控制。后面同对非保护的文档保护。网络文件，不设置则默认为保护文档， [3,null,"random"]，产生随机密码，密码不可获取，请慎重处理。不保护设置为[-1] 对本地文件不默认处理
Unprotect	pwd	文档解锁密码	对保护的文档(type!=-1)输入解锁密码Unprotect不保护。

1. 1. 1. 1. Excel 其它参数

更多https://docs.microsoft.com/zh-cn/office/vba/api/overview/excel

名称	设置	含义	说明
Par0		可选。
src	[path, openPar]	( UpdateLinks、 ReadOnly、 Format、 Password、 WriteResPassword、 IgnoreReadOnlyRecommended、原产地、定界符、可编辑、通知、转换器、 AddToMru、 Local、 CorruptLoad)	["/demo/htmlDemo/file/x1.xlsx",null,1] [[https://cdn.jsdelivr.net/gh/appemit/AppEmitWeb@master/docs/demo/file/x1.tmp,"x11.xlsx"]] https://docs.microsoft.com/zh-cn/office/vba/api/excel.workbooks.open
ViewType	1	xlNormalView 1 正常。 xlPageBreakPreview 双面分页预览。 xlPageLayoutView 第三章页面视图
Protect	数组[]	（Password、 DrawingObjects、内容、场景、 UserInterfaceOnly、 AllowFormattingCells、 AllowFormattingColumns、 AllowFormattingRows、 AllowInsertingColumns、 AllowInsertingRows、 AllowInsertingHyperlinks、 AllowDeletingColumns、 AllowDeletingRows、 AllowSorting、 AllowFiltering、 AllowUsingPivotTables)	对所有已经已存工作表保护注意AllowFiltering参数 https://docs.microsoft.com/zh-cn/office/vba/api/excel.worksheet.protect
Unprotect	pwd	文档解锁密码	输入解锁密码Unprotect不保护。
Activate_ID	1,数值或者字符串	工作表的序号(左边第一为1)，或者名称.默认打开的第几个工作表,或者为该名称的工作表	暂未启用

1. 1. 1. 1. PowerPoint 其它参数

更多https://docs.microsoft.com/zh-cn/office/vba/api/overview/powerpoint

名称	设置	含义	说明
Par0		可选。
src	[path, openPar]	（ReadOnly、Untitled无标题、 WithWindow）	https://docs.microsoft.com/zh-cn/office/vba/api/powerpoint.presentations.open
ViewType	1	ppViewHandoutMaster '讲义母版4 ppViewMasterThumbnails '缩略图母版12 ppViewNormal '普通视图9 ppViewNotesMaster '备注母版5 ppViewNotesPage '备注页3 ppViewOutline '大纲视图6 ppViewPrintPreview '打印预览10 ppViewSlide '幻灯片视图1 ppViewSlideMaster '幻灯片母版2 ppViewSlideSorter '幻灯片浏览7 ppViewThumbnails '缩略图视图11 ppViewTitleMaster '标题母版8	ppt ppViewType 类型

1. 1. 1. 1. 更多示例
打开本地txt,只读，不显示标题栏，显示工具栏，不上传

{"emit":"open","Obj":"office","AppType":1,"src":"/demo/htmlDemo/file/t1.txt" ,"pos":1,"par0":{"openPar":[null,true],"Titlebar":0,"ProtectDoc":0,"Menubar":0,"Toolbars":0,"btnFile":0,"HttpPost":{"URL":"http://eu.httpbin.org/post","valid":0,"fileName":"s1.docx"},"MNU_NEWBLANK":0,"MNU_NEW":0,"MNU_OPEN":0,"MNU_CLOSE":0,"MNU_SAVE":0,"MNU_SAVEAS":0,"MNU_PGSETUP":0,"MNU_PRINT":0,"MNU_PROPS":0,"show_UpdateTool":true}}

打开网络excel, 重命名，不显示标题栏，显示工具栏，不上传

{"emit":"open","Obj":"office","AppType":2,"src":["https://cdn.jsdelivr.net/gh/appemit/AppEmitWeb@master/docs/demo/file/x1.tmp","a1.xlsx"],"pos":1,"par0":{"Titlebar":0,"Menubar":1,"Toolbars":1,"btnFile":0,"HttpPost":{"URL":"http://eu.httpbin.org/post","valid":0},"MNU_NEWBLANK":0,"MNU_NEW":0,"MNU_OPEN":0,"MNU_CLOSE":0,"MNU_SAVE":0,"MNU_SAVEAS":0,"MNU_PGSETUP":0,"MNU_PRINT":0,"MNU_PROPS":0,"show_UpdateTool":true}}

打开网络ppt, 重命名，幻灯片视图，不显示标题栏，显示工具栏，不上传

{"emit":"open","Obj":"office","AppType":3,"src":["https://cdn.jsdelivr.net/gh/appemit/AppEmitWeb@master/docs/demo/file/p1.tmp","p1.pptx"],"pos":1,"par0":{"ViewType":1,"Titlebar":0,"Menubar":1,"Toolbars":1,"btnFile":0,"HttpPost":{"URL":"http://eu.httpbin.org/post","valid":0},"MNU_NEWBLANK":0,"MNU_NEW":0,"MNU_OPEN":0,"MNU_CLOSE":0,"MNU_SAVE":0,"MNU_SAVEAS":0,"MNU_PGSETUP":0,"MNU_PRINT":0,"MNU_PROPS":0,"show_UpdateTool":true}}

1. 1. 1. 1. 疑难
要确保单独使用word打开，文件格式不报错，否则打不开。
比如文档格式不对，需要重新另存打开，否则会出现等未知报错。
选择保存时如果时间过长，会出现服务器正在运行中，需要在任务管理器关闭对应的word\execel\ppt的进程，重新启动。
Office自动化初始化

Office 服务器 CLSID 项

Access.Application {73A4C9C1-D68D-11D0-98BF-00A0C90DC8D9}

Excel.Application {00024500-0000-0000-C000-000000000046}

FrontPage.Application {04DF1015-7007-11D1-83BC-006097ABE675}

Outlook.Application {0006F03A-0000-0000-C000-000000000046}

Application.Application {91493441-5A91-11CF-8700-00AA0060263B}

Word.Application {000209FF-0000-0000-C000-000000000046}

在运行中

D:\PROGRA~1\MICROS~1\Office15\WINWORD.EXE /RegServer

检查HKEY_CLASSES_ROOT\CLSID CLSID项的 LocalServer32

D:\PROGRA~1\MICROS~1\Office15\EXCEL.EXE /automation

D:\PROGRA~1\MICROS~1\Office15\WINWORD.EXE /Automation

D:\PROGRA~1\MICROS~1\Office15\POWERPNT.EXE /AUTOMATION

1. 1. 1. WPS

创建、打开阅读、编辑金山Office文件，支持本地和网络文件, 包括wps\et\wpp文件

更多VBA官方参考 https://open.wps.cn/docs/office wps客户端开发

和office基本一致，主要设置progId 参数和增加了attach 参数

或者录制宏，编辑参考代码。

{"emit":"open","Obj":"office","AppType":1,"src":"/demo/htmlDemo/file/d1.docx","pos":1,"par0":{"attach":1,"progId": "KWPS.Application","noMinMax":1,"ViewType":1,"Titlebar":0,"Menubar":1,"Toolbars":1,"btnFile":0}}

名称	设置	含义	说明
emit	open	必需。打开office事件请求。
Obj	office	必需。
AppType	1	必需。 word excel powerpoint	有默认的右键菜单。若为负数-1,则是浮动窗口
src	字符串； path为 [path, openPar]	path为必需, 字符串网址或者本地相对或者绝对路径 ,或者数组（防止网页src里面没有文件名称或者后缀名称需要修改，则使用fileType ）。 openPar: 具体不同。 "/demo/htmlDemo/file/x1.xls" ["/demo/htmlDemo/file/x1.xls" ,openPar] [[http://.../demo/htmlDemo/file/x1.xls,"x2.xlsx"],openPar]	Word系列文件 Excel系列文件 PPT系列文件不同应用的openPar不同，详细见后
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。	对不同的浏览器，自动识别的位置需要优化
AppShow		必需。 true App可见 false App不可见	通常空时默认为true 调用comm为false
AppFollow		必需。空时默认为true 1 跟随变化 0 不变化	AppShow为true时，App随浏览器移动变形隐藏显示等事件
Par0		可选。
progId	"KWPS.Application" 或者[]	默认为MS office ["KWPS.Application","WPS.Application"] ["KET.Application","ET.Application"] ["WPP.Application","WPP.Application"]	采用不同自动化服务器打开文档、表格、幻灯片，按顺序依次尝试。
attach	1	附着APP方式	wps最好采用此方式
noMinMax	1	1 禁用关闭最小最大化按钮 0/null 可最大小化关闭	遮盖

其它参数见Office章节，注意金山wps的VBA代码和微软的不一定相同。

1. 1. 1. Office javaScript
      1. 嵌入网页JS控制

在前章节的基础上，增加一个javaScipt文件或者html文件，在officeJs中添加代码控制office,支持word excel ppt。更多参考VBA和宏录制。

更多https://docs.microsoft.com/zh-cn/office/vba/api/overview/word

{"emit":"open","Obj":"office","AppType":1,"src":"/demo/htmlDemo/file/d1.docx","pos":1,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"/demo/htmlDemo/js/officeJs.html","webJs":1},"par0":{"Titlebar":0,"Menubar":0,"Toolbars":0,"btnFile":0,"Statusbar":0 }}

在websocket中打开d1.docx,实际在par的文件/demo/htmlDemo/ officeJs.html中的js修改打开d2.doc,并且增加输入文字功能。

名称	设置	含义	说明
emit	open	必需。打开office事件请求。
Obj	office	必需。
AppType	1	必需。 word excel powerpoint	有默认的右键菜单。若为负数-1,则是浮动窗口
src	字符串； path为 [path, openPar]	path为必需, 字符串网址或者本地相对或者绝对路径 ,或者数组（防止网页src里面没有文件名称或者后缀名称需要修改，则使用fileType ）。 openPar: 具体不同。 "/demo/htmlDemo/file/x1.xls" ["/demo/htmlDemo/file/x1.xls" ,openPar] [[http://.../demo/htmlDemo/file/x1.xls,"x2.xlsx"],openPar]	Word系列文件 Excel系列文件 PPT系列文件不同应用的openPar不同，详细见后
par			下面三个参数必须有一个。
htmlStr		Html代码
HttpServer_startUrl		以服务器形式打开本地html文件路径，可以是绝对或者相对路径。/为分隔符。
URL	http://www.appemit.com.../ officeJs.html 或者 /demo/htmlDemo/js/officeJs.html	支持网页地址或者本地html文件路径。
webJs	1	启用par的设置的嵌入网页JS 1 IE 2 webkit 3 blink 0 关闭	或者设置为0，把officeJs的src参数设置在src里面。使用runCmd执行输入命令。

在officeJs.html中也可以设置src参数。

webJs0

0 关闭本js的控制，即使webJs大于0

注释后启用。

系统默认执行了4个过程接口

AppJs_init

AppJs_loaded

AppJs_destroy

AppJs_closed

AppJs_init=function(AppType)

如果在浏览器网页中没有设置src，可以在这里设置。

webJs0，0 关闭本js的控制

objName:"word" 为程序对象名称，可不设置，自动根据AppType判断。如果修改了为word1，则后面的AppJsObject.word.Selection，应该修改为AppJsObject.word1.Selection

AppJs_loaded=function(AppType){

//系统启动APP ,产生AppJsObject.objName对象后执行

定义了全局变量AppJsObject.word

Selection=AppJsObject.word.Selection;Application=AppJsObject.word.Application;' //注意结尾一定要有; 或者\r\n

AppJs_destroy=function(){ //AppJsObject.objName销毁前执行

AppJs_closed=function(status){ //AppJsObject.objName关闭后执行。已经没有AppJsObject.objName对象了

1. 1. 1. 1. 浏览器网页执行代码命令控制

Var Req={"emit":"runCmd","Obj":"office","codeStr": "Selection.TypeParagraph();Selection.TypeText("控制插入一句话-runCmd"); } "

EmitReq(Req);

通过前面officeJs.html定义的AppJsObject.objName，可以直接控制office。当然也可以不需要officeJs.html定义，能在浏览器网页中websocket发送使用"emit":"runCmd"命令发送AppJs_init、AppJs_loaded，代码也可以。

可以添加js文件或者html，在html还能动态控制office，更多功能请联系我们。

1. 1. 1. Office DsoFramer

创建、打开阅读、编辑Office文件，支持本地和网络文件, 包括word\excel\PPT文件

{"emit":"open",

"Obj":"office",

"AppType":8,

"src":"/demo/htmlDemo/file/x1.xls",

"pos":1,

"par0":{"Caption":true,

"ProtectDoc":0,

"Toolbars":true,

"btnFile":true,

"MNU_NEWBLANK":0,

"MNU_NEW":0,

"MNU_OPEN":0,

"MNU_CLOSE":0,

"MNU_SAVE":0,

"MNU_SAVEAS":0,

"MNU_PGSETUP":0,

"MNU_PRINT":0,

"MNU_PROPS":0,

"show_UpdateTool":true}

}

名称	设置	含义	说明
emit	open	必需。打开office事件请求。
Obj	office	必需。
AppType	8	必需。 8 DsoFramer	有默认的右键菜单。若为负数-1,则是浮动窗口
src	字符串src 网址或者本地相对或者绝对路径或者数组 [src,flag, ProgId ,username,pwd,fileType]	src为必需。 flag:true/false ProgId: Word.Document Excel.Sheet PowerPoint.Show Visio.Drawing filename:temp.doc等防止src里面没有文件名称或者后缀名称不对，则使用fileType； {"/demo/htmlDemo/file/x1.xls",true, "Excel.Sheet","name","PWD"}	Word系列文件 Excel系列文件 PPT系列文件 fileType
pos	{"left":372,"top":203,"width":606,"height":406}	必需。 1 默认使用代码自动识别的位置。	对不同的浏览器，自动识别的位置需要优化
Par0		可选。
Caption	0	默认 false True 显示路径 string显示具体string 0/false/null	AppType为负数时候显示标题栏
ProtectDoc	0	默认 0 ，保护文档 1 肯定，解锁密码为随机字符串，不可获得。 String, 解锁密码为具体String 0 可编辑文档
Toolbars	1	默认 1 ，显示工具栏 1 显示 0 不显示
btnFile	1	工具栏的文件File按钮 1 /true 默认显示 0	Toolbars为真时有效
ShowView	1	wdNormalView = 1, wdOutlineView = 2, wdPrintView = 3, wdPrintPreview = 4, wdMasterView = 5, //这个是大纲 wdWebView = 6
HttpPost	{"URL":"url", "method":"POST" "username":"name" "username":"*" "cookie":null}	URL上传的地址，必需 method 上传的方法POST\GET,默认POST cookie	如果上传，URL必需。
MNU_UPLOAD	0	默认 0 ，工具栏上传命令菜单 1 显示上传提交 0 不显示	Toolbars、btnFile、HttpPost["URL"] 同时为真时有效
MNU_NEWBLANK	0	默认 0 ，工具栏FILE命令菜单 1 显示新建空白 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_NEW	0	默认 0 ，工具栏FILE命令菜单 1 显示新建 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_OPEN	0	默认 0 ，工具栏FILE命令菜单 1 显示打开 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_CLOSE	0	默认 0 ，工具栏FILE命令菜单 1 显示关闭 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_SAVE	0	默认 0 ，工具栏FILE命令菜单 1 显示保存 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_SAVEAS	0	默认 0 ，工具栏FILE命令菜单 1 显示另存 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_PGSETUP	0	默认 0 ，工具栏FILE命令菜单 1 显示页面设置 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_PRINT	0	默认 0 ，工具栏FILE命令菜单 1 显示打印 0 不显示	Toolbars、btnFile 同时为真时有效
MNU_PROPS	0	默认 0 ，工具栏FILE命令菜单 1 显示属性 0 不显示	Toolbars、btnFile 同时为真时有效
show_UpdateTool	0	在配置文件设置默认值 0 1显示更新文件下载窗口 0不显示

1. 1. 1. 1. 更多示例
打开网络docx, 不显示工具栏，保护文档

{"emit":"open","Obj":"office","AppType":8,"src":["https://cdn.jsdelivr.net/gh/appemit/AppEmitWeb@master/docs/demo/file/d1.tmp",false, "Word.Document","userName","PWD","tmp.docx"] ,"pos":1,"par0":{"Caption":true,"ProtectDoc":0,"Toolbars":0,"btnFile":true,"MNU_NEWBLANK":0,"MNU_NEW":0,"MNU_OPEN":0,"MNU_CLOSE":0,"MNU_SAVE":0,"MNU_SAVEAS":0,"MNU_PGSETUP":0,"MNU_PRINT":0,"MNU_PROPS":0,"show_UpdateTool":true}}

打开网络xlsx, 显示工具栏，显示文件按钮,上传文件(提交地址需要修改)

{"emit":"open","Obj":"office","AppType":8,"src":["https://cdn.jsdelivr.net/gh/appemit/AppEmitWeb@master/docs/demo/file/x1.tmp",false,"Excel.Sheet","userName","PWD","a1.xlsx"],"pos":1,"par0":{"Caption":true,"ProtectDoc":0,"Toolbars":1,"btnFile":true,"HttpPost":{"URL":"http://eu.httpbin.org/post","fileName":"s1.xlsx"},"MNU_UPLOAD":1,"MNU_NEWBLANK":1,"MNU_NEW":0,"MNU_OPEN":0,"MNU_CLOSE":0,"MNU_SAVE":0,"MNU_SAVEAS":0,"MNU_PGSETUP":0,"MNU_PRINT":0,"MNU_PROPS":0,"show_UpdateTool":true}}

打开本地pptx,显示工具栏，不显示文件按钮

{"emit":"open","Obj":"office","AppType":8,"src":["/demo/htmlDemo/file/p1.pptx",false,"PowerPoint.Show","name","PWD"] ,"pos":1,"par0":{"Caption":0,"ProtectDoc":1,"Toolbars":1,"btnFile":0,"MNU_NEWBLANK":0,"MNU_NEW":0,"MNU_OPEN":0,"MNU_CLOSE":0,"MNU_SAVE":0,"MNU_SAVEAS":0,"MNU_PGSETUP":0,"MNU_PRINT":0,"MNU_PROPS":0,"show_UpdateTool":true}}

1. 1. 1. 1. 其它参数

文档另存为

HRESULT SaveAs([in] VARIANT strFileName, [in] VARIANT dwFileFormat, [out,retval] long* pbool);

参数：

strFileName：文件本地路径，如c:\\11.doc

dwFileFormat: 文件格式

Excel: Type
enum XlFileFormat

Word: Type
enum WdSaveFormat

PPT:
enum PpSaveAsFileType

xlAddIn = 18

xlCSV = 6

xlCSVMac = 22

xlCSVMSDOS = 24

xlCSVWindows = 23

xlDBF2 = 7

xlDBF3 = 8

xlDBF4 = 11

xlDIF = 9

xlExcel2 = 16

xlExcel2FarEast = 27

xlExcel3 = 29

xlExcel4 = 33

xlExcel5 = 39

xlExcel7 = 39

xlExcel9795 = 43

xlExcel4Workbook = 35

xlIntlAddIn = 26

xlIntlMacro = 25

xlWorkbookNormal = -4143

xlSYLK = 2

xlTemplate = 17

xlCurrentPlatformText = -4158

xlTextMac = 19

xlTextMSDOS = 21

xlTextPrinter = 36

xlTextWindows = 20

xlWJ2WD1 = 14

xlWK1 = 5

xlWK1ALL = 31

xlWK1FMT = 30

xlWK3 = 15

xlWK4 = 38

xlWK3FM3 = 32

xlWKS = 4

xlWorks2FarEast = 28

xlWQ1 = 34

xlWJ3 = 40

xlWJ3FJ3 = 41

xlUnicodeText = 42

xlHtml = 44

wdFormatDocument = 0

wdFormatTemplate = 1

wdFormatText = 2

wdFormatTextLineBreaks = 3

wdFormatDOSText = 4

wdFormatDOSTextLineBreaks = 5

wdFormatRTF = 6

wdFormatUnicodeText = 7

wdFormatEncodedText = 7

wdFormatHTML = 8

ppSaveAsPresentation = 1

ppSaveAsPowerPoint7 = 2

ppSaveAsPowerPoint4 = 3

ppSaveAsPowerPoint3 = 4

ppSaveAsTemplate = 5

ppSaveAsRTF = 6

ppSaveAsShow = 7

ppSaveAsAddIn = 8

ppSaveAsPowerPoint4FarEast = 10

ppSaveAsDefault = 11

ppSaveAsHTML = 12

ppSaveAsHTMLv3 = 13

ppSaveAsHTMLDual = 14

ppSaveAsMetaFile = 15

ppSaveAsGIF = 16

ppSaveAsJPG = 17

ppSaveAsPNG = 18

ppSaveAsBMP = 19

1. 1. 1. 1. 疑难

DsoFramer是微软的开源控件，现在已经不更新，容易出现bug。

比如文档格式不对，需要重新保存在打开，否则会出现两个窗口等未知报错。

选择保存时如果时间过长，会出现服务器正在运行中，需要在任务管理器关闭对应的word\execel\ppt的进程，重新启动。

1. 1. 1. 第三方DLL\组件调用
      1. 使用IE内核打开ActiveX

使用IE内核打开网页,在非IE浏览器中调用activeX控件,及使用原有的html的代码即可。这种方法通常需要注册对应的activeX

1. 1. 1. 1. 可视化Flash ocx 调用

能在网页中执行命令，控制flash,举例见demo/htmlDemo/dll.html

{"emit":"open","Obj":"dll","AppType":1,"src":[],"pos":1,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"/demo/htmlDemo/js/dllJs.html","webJs":1}

调用C:/Windows/SysWOW64/Macromed/Flash/Flash32_32_0_0_403.ocx 控件，需要自行安装flash.

可以在dllJs.html进一步设置参数AppType==1情况，和过程调用代码。同时也能通过浏览器网页发布命令。

名称	设置	含义	说明
emit	open	必需。打开dll事件请求。
Obj	dll	必需。
AppType	1	必需。根据自己的代码确定。	有默认的右键菜单。若为负数-1,则是浮动窗口
src	字符串数组	打开多个DLL，只能一个可视化
par			下面三个参数必须有一个。
htmlStr		Html代码
HttpServer_startUrl		以服务器形式打开本地html文件路径，可以是绝对或者相对路径。/为分隔符。
URL	http://www.appemit.com.../ dllJs.html 或者 /demo/htmlDemo/js/ dllJs.html	支持网页地址或者本地html文件路径。
webJs	1	启用par的设置的嵌入网页JS 1 IE 2 webkit 3 blink 0 关闭	或者设置为0，把dllJs的src参数设置在src里面。使用runCmd执行输入命令。
par0
AppMethod	null	默认非必需。 POST。同步呼叫的控件，应该设置为POST，采取websocket相同的异步通话

在dllJs.html中也可以设置src参数。

webJs0

0 关闭本js的控制，即使webJs大于0

注释后启用。

系统默认执行了4个过程接口

AppJs_init

AppJs_loaded

AppJs_destroy

AppJs_closed

1. 1. 1. 1. 嵌入网页JS控制

AppJs_init=function(AppType)

如果在浏览器网页中没有设置src，可以在这里设置。

webJs0，0 关闭本js的控制

createType:"createEmbed" //可视化的控件 createEmbed(comCarrier,clsId,iid) ,只能有一个 , createObject(clsId,iid) createInstance(clsId,itface) createUnknown(clsId,iid)

,comName:"flash" //ocx

,objName:"shockwave"

//,comCarrier:"custom" // createEmbed可视化 picture(图片控件设置)、static 、 winform 默认推荐 custom //不同类型组件采取不要载体

,dllFile:"C:/Windows/SysWOW64/Macromed/Flash/Flash32_32_0_0_403.ocx" // 必须 \\ /

,clsId :"D27CDB6E-AE6D-11CF-96B8-444553540000" //guid

,iid:null

,itface:null

,embedObject:null

AppJs_loaded=function(AppType){

//系统启动APP ,产生AppJsObject. shockwave对象后执行

AppJsObject.shockwave.Movie = "/demo/htmlDemo/file/test1.swf"

AppJs_destroy=function(){ //AppJsObject.shockwave销毁前执行

AppJs_closed=function(status){ //AppJsObject.shockwave关闭后执行。已经没有AppJsObject.shockwave对象了

1. 1. 1. 1. 浏览器网页执行代码命令控制

if (cmdId=="stop" ){

codeStr = txt2code(function(){/*

AppJsObject.shockwave.stop();

return {status="stop"}

*/});

} else if(cmdId=="play" ){

codeStr = txt2code(function(){/*

AppJsObject.shockwave.play();

return {status="play"}

*/});

}

Var Req={"emit":"runCmd","Obj":"dll","codeStr": codeStr}

EmitReq(Req);

通过前面dllJs.html定义的AppJsObject.shockwave，可以直接控制flash。当然也可以不需要dllJs.html定义，能在浏览器网页中websocket发送使用"emit":"runCmd"命令发送AppJs_init、AppJs_loaded，代码也可以。

1. 1. 1. 1. 报表控件reportX调用

能在网页中执行命令，控制reportX,举例见demo/htmlDemo/dll.html

调用"/plugins/thirdparty/report/ReportX.ocx" 控件

可以在dllJs.html进一步设置参数AppType==2情况，和过程调用代码。

同时也能通过浏览器网页发布命令。

名称	设置	含义	说明
emit	open	必需。打开dll事件请求。
Obj	dll	必需。
AppType	2	必需。根据自己的代码确定。	有默认的右键菜单。若为负数-1,则是浮动窗口
src	字符串数组	打开多个DLL，只能一个可视化
par			下面三个参数必须有一个。
htmlStr		Html代码
HttpServer_startUrl		以服务器形式打开本地html文件路径，可以是绝对或者相对路径。/为分隔符。
URL	http://www.appemit.com.../ dllJs.html 或者 /demo/htmlDemo/js/ dllJs.html	支持网页地址或者本地html文件路径。
webJs	1	启用par的设置的嵌入网页JS 1 IE 2 webkit 3 blink 0 关闭	或者设置为0，把dllJs的src参数设置在src里面。使用runCmd执行输入命令。
par0
AppMethod	null	默认非必需。 POST。同步呼叫的控件，应该设置为POST，采取websocket相同的异步通话

在dllJs.html中也可以设置src参数。

webJs0

0 关闭本js的控制，即使webJs大于0

注释后启用。

系统默认执行了4个过程接口

AppJs_init

AppJs_loaded

AppJs_destroy

AppJs_closed

1. 1. 1. 1. 嵌入网页JS控制

AppJs_init=function(AppType)

如果在浏览器网页中没有设置src，可以在这里设置。

src:[ {

// webJs0:0, //只能设置为0 关闭本js的控制 ; 或者注释为默认打开控制

createType:"createEmbed" //可视化的控件createEmbed(comCarrier,clsId,iid) , createObject(clsId,iid) createInstance(clsId,itface) createUnknown(clsId,iid)

,comName:"reportXOCX"

,objName:"reportX"

// ,comCarrier:"custom" // createEmbed可视化 picture(图片控件设置)、static 、winform 默认推荐 custom //不同类型组件采取不要载体

,dllFile:"/plugins/thirdparty/report/ReportX.ocx"

,clsId :"A5DA6E97-1D4C-4708-B705-84A45716B4DD" //guid

,iid:null

,itface:null

,embedObject:null

} //暂时支持一个控件

]

AppJs_loaded=function(AppType){

//系统启动APP ,产生AppJsObject.reportX对象后执行

AppJs_destroy=function(){ //AppJsObject.reportX销毁前执行

AppJs_closed=function(status){ //AppJsObject.reportX关闭后执行。已经没有AppJsObject.reportX对象了

1. 1. 1. 1. 浏览器网页执行代码命令控制

if(cmdId=="reportX_open" ){

codeStr = txt2code(function(){/*

//AppJsObject.reportX.OpenReport(..io.fullpath("/demo/htmlDemo/file/rep1.rpxe"))

var reportXPath=AppJs.dlgOpen('rpxe|*.rpxe|所有文件|*.*||')

AppJsVar_reportXPath=reportXPath; //全局变量 ,没有var

if reportXPath {AppJsObject.reportX.OpenReport(reportXPath)

return {status="open reportX"; path=reportXPath}

}else {

return null;

}

*/});

}else if(cmdId=="reportX_save" ){

//方案1 通过websocket交互信息.

if ( !reportXPath) return;

codeStr = 'AppJsObject.reportX.SaveReport("'+reportXPath+'") \ //通过websocket交互信息，或者直接采取全局变量

return {status="save reportX"}' ;

// 方案2 直接采取全局变量

codeStr = 'AppJs.msgbox(AppJsVar_reportXPath); AppJsObject.reportX.SaveReport(AppJsVar_reportXPath);'

codeStr+= 'return {status="save reportX 2"}' ;

// 方案3 另存为

// codeStr = "var savePath=AppJs.dlgSave('rpxe|*.rpxe|所有文件|*.*||','另存为') if (savePath) AppJsObject.reportX.SaveReport(savePath);"

}Var Req={"emit":"runCmd","Obj":"dll","codeStr": codeStr}

EmitReq(Req);

通过前面dllJs.html定义的AppJsObject.reportX，可以直接控制reportX。当然也可以不需要dllJs.html定义，能在浏览器网页中websocket发送使用"emit":"runCmd"命令发送AppJs_init、AppJs_loaded，代码也可以。

1. 1. 1. 1. 第三方dll调用
dll_demodll安装在/plugins/thirdparty/dll_demodll

能在网页中执行命令，控制dll_demo1,举例见demo/htmlDemo/dll.html

同时也能通过浏览器网页发布命令。

名称	设置	含义	说明
emit	open	必需。打开dll事件请求。
Obj	dll	必需。
AppType	4	必需。根据自己的代码确定。	有默认的右键菜单。若为负数-1,则是浮动窗口
src	字符串数组	打开多个DLL，只能一个可视化
pos	0	无界面不需要
AppShow	false	必需。窗口不可见。无界面必需设置false。
par
htmlStr		Html代码	下面三个参数必须有一个。
HttpServer_startUrl		以服务器形式打开本地html文件路径，可以是绝对或者相对路径。/为分隔符。
URL	http://www.appemit.com.../ dllJs.html 或者 /demo/htmlDemo/js/ dllJs.html	支持网页地址或者本地html文件路径。
webJs	1	启用par的设置的嵌入网页JS 1 IE 2 webkit 3 blink 0 关闭	或者设置为0，把dllJs的src参数设置在src里面。使用runCmd执行输入命令。
par0
AppMethod	null	默认非必需。 POST。同步呼叫的控件，应该设置为POST，采取websocket相同的异步通话
backNoJson	true/false	默认false,反馈为json true,调用的dll或者ocx反馈的数据直接发送，不处理编码或者json转换	反馈的数据处理
codePage	65001	65001 utf8 1200 UCS-2LE 1201 UCS-2BE 0 不处理	反馈的数据编码，默认65001

在dllJs.html中也可以设置src参数。

webJs0

0 关闭本js的控制，即使webJs大于0

注释后启用。

系统默认执行了4个过程接口

AppJs_init

AppJs_loaded

AppJs_destroy

AppJs_closed

1. 1. 1. 1. 嵌入网页JS控制

演示调用dll的add方法，主要是初始化后，声明dll.api( "Add","int(int a,int b)", "cdecl" ); //必须是cdecl 声明

AppJs_init=function(AppType)

如果在浏览器网页中没有设置src，可以在这里设置。

src:[ {

// webJs0:0, //只能设置为0 关闭本js的控制 ; 或者注释为默认打开控制

createType:"createDll" // dll调用

,objName:"dll_demo1"

,dllFile:"/plugins/private/50FCF891-1B93-4AE5-8A66-AB26A3C03378/dll_demo1.dll" // 必须 \\ / 放在/plugins/private/clsId/文件夹下面

,clsId :"50FCF891-1B93-4AE5-8A66-AB26A3C03378" //guid 发送给dll 信息

,iid:null

,data:'{"msg":"init from JS","info":1}' //发送给dll 数据

} //暂时支持一个控件

]

,AppShow:false //整体不可见必须设置，默认可见

// dll 接口__declspec(dllexport) int Add(int a, int b )

//自行声明接口，再调用。

AppJsObject.dll_demo1.myAdd =AppJsObject.dll_demo1.dll.api( "Add","int(int a,int b)", "cdecl" ); //必须是cdecl 声明

var sum=AppJsObject.dll_demo1.myAdd(3,5);

//AppJs.log(sum);

AppJs.msgbox(sum);

return {data=sum}; //结果在 external.out 中

1. 1. 1. 1. 浏览器网页执行代码命令控制

//或者浏览器网页发布命令runCmd,执行AppDll_RevMsg方法

codeStr= txt2code(function(){/ *

var sum=AppJsObject.dll_demo1.myAdd(3,5);

return sum;

* /});

var Req={"emit":"runCmd","Obj":"dll","codeStr":codeStr }

EmitReq(Req);

1. 1. 1. 自行Dll开发调用
      1. dll_demo1调用
dll_demo1.dll安装在/plugins/private/50FCF891-1B93-4AE5-8A66-AB26A3C03378/dll_demo1.dll"

能在网页中执行命令，控制dll_demo1,举例见demo/htmlDemo/dll.html

{"emit":"open","Obj":"dll","AppType":3,"src":[],,"AppShow":false "pos":0,"par":{"htmlStr":null,"HttpServer_startUrl":null,"URL":"/demo/htmlDemo/js/dllJs.html","webJs":1 },"par0":{"AppMethod":"msg Synchronization component need set: POST" }}

可以在dllJs.html进一步设置参数AppType==3情况，和过程调用代码。

同时也能通过浏览器网页发布命令。

名称	设置	含义	说明
emit	open	必需。打开dll事件请求。
Obj	dll	必需。
AppType	3	必需。根据自己的代码确定。	有默认的右键菜单。若为负数-1,则是浮动窗口
src	字符串数组	打开多个DLL，只能一个可视化
pos	0	无界面不需要
AppShow	false	必需。窗口不可见。无界面必需设置false。
par
htmlStr		Html代码	下面三个参数必须有一个。
HttpServer_startUrl		以服务器形式打开本地html文件路径，可以是绝对或者相对路径。/为分隔符。
URL	http://www.appemit.com.../ dllJs.html 或者 /demo/htmlDemo/js/ dllJs.html	支持网页地址或者本地html文件路径。
webJs	1	启用par的设置的嵌入网页JS 1 IE 2 webkit 3 blink 0 关闭	或者设置为0，把dllJs的src参数设置在src里面。使用runCmd执行输入命令。
par0
AppMethod	null	默认非必需。 POST。同步呼叫的控件，应该设置为POST，采取websocket相同的异步通话
codePage	65001	65001 utf8 1200 UCS-2LE 1201 UCS-2BE 0 不处理	反馈的数据编码，默认65001
backNoJson	true/false	默认false,反馈为json true,调用的dll或者ocx反馈的数据直接发送，不处理编码或者json转换	反馈的数据处理

在dllJs.html中也可以设置src参数。

webJs0

0 关闭本js的控制，即使webJs大于0

注释后启用。

系统默认执行了4个过程接口

AppJs_init

AppJs_loaded

AppJs_destroy

AppJs_closed

1. 1. 1. 1. 嵌入网页JS控制

AppJs_init=function(AppType)

如果在浏览器网页中没有设置src，可以在这里设置。

src:[ {

// webJs0:0, //只能设置为0 关闭本js的控制 ; 或者注释为默认打开控制

createType:"createDll" // dll调用

,objName:"dll_demo1"

,dllFile:"/plugins/private/50FCF891-1B93-4AE5-8A66-AB26A3C03378/dll_demo1.dll" // 必须 \\ / 放在/plugins/private/clsId/文件夹下面

,clsId :"50FCF891-1B93-4AE5-8A66-AB26A3C03378" //guid 发送给dll 信息

,iid:null

,data:'{"msg":"init from JS","info":1}' //发送给dll 数据

} //暂时支持一个控件

]

,AppShow:false //整体不可见必须设置，默认可见

AppJs_loaded=function(AppType){

//系统启动APP ,产生AppJsObject. shockwave对象后执行

AppJsObject.dll_demo1.AppDll_loaded(AppDll_hwnd, "",{"msg":"loaded from JS","info":2}');

AppJs_destroy=function(){ //AppJsObject.shockwave销毁前执行

AppJsObject.dll_demo1.AppDll_destroy(AppDll_hwnd, "",'{"msg":"destroy from JS","info":3}');

AppJs_closed=function(status){ //AppJsObject关闭后执行。已

1. 1. 1. 1. 浏览器网页执行代码命令控制

codeStr= txt2code(function(){/*

AppJsObject.dll_demo1.AppDll_RevMsg(AppDll_hwnd,'','{"data":"send from JS","info":3}');

* /});

var Req={"emit":"runCmd","Obj":"dll","codeStr":codeStr }

EmitReq(Req);

1. 1. 关闭APP
    1. 关闭cid对应APP

{"emit":"close","AppId ":1}

名称	设置	含义	说明
emit	close	必需。关闭控件APP通信事件请求。
AppId	1,2…	必需。具体的可调整。
Obj	flash	非必需。

1. 1. 1. 关闭cid所有APP

{"emit":"closeAll"}

名称	设置	含义	说明
emit	closeAll	必需。关闭所有控件APP通信事件请求。	关闭在cid下运行的所有控件APP

1. 1. 窗口
    1. 显示

{"emit":"show","Obj":"flash"}

名称	设置	含义	说明
emit	show	必需。显示窗口请求。
Obj	flash	必需。
AppShow	true/null	默认null 可视化 false 不可见
pos		可选
par0
debounce	300	默认300毫秒	防抖函数，在限定的延时内仅保留最后一次调用，延时默认300毫秒

1. 1. 1. 隐藏

{"emit":"hide","Obj":"flash"}

名称	设置	含义	说明
emit	hide	必需。隐藏窗口请求。
Obj	flash	必需。

1. 1. 1. 移动

{"emit":"move","Obj":"flash","pos":{"left":10,"top":6,"width":206,"height":106}}

名称	设置	含义	说明
emit	move	必需。移动窗口请求。
Obj	flash	必需。
pos	屏幕绝对位置	必需。
par0
debounce	300	默认300毫秒	防抖函数，在限定的延时内仅保留最后一次调用，延时默认300毫秒

1. 获得参数

{"emit":"getPar","Obj":"clientAuth"}

名称	设置	含义	说明
emit	getPar	必需。获得参数请求。
Obj	clientAuth	是否授权 1 授权 0 无

1. 设置参数

{"emit":"setPar","Obj":"flash","topMost":true}

名称	设置	含义	说明
emit	getPar	必需。获得参数请求。
Obj	flash	必需。
topMost		必需。 True 置顶 False 取消置顶

1. AppEmit操作
  1. 错误信息

{"emit":" lasterr"}

名称	设置	含义	说明
emit	lasterr	必需。获得最近错误请求。	"

1. 1. 重启

{"emit":"restart","Obj":"AppEmit"}

名称	设置	含义	说明
emit	restart	必需。AppEmit重启请求。	重启后client需要重新连接。
Obj	AppEmit	必需。

1. 1. 更新

{"emit":"update","Obj":"AppEmit"}

名称	设置	含义	说明
emit	update	必需。询问AppEmit是否更新程序请求。	默认强制更新。如果config.ini里面设置autoUpdate=0，则询问更新。
Obj	AppEmit	必需。

1. 1. 关于

{"emit":"about","Obj":"AppEmit"}

名称

设置

含义

说明

emit

about

必需。获得关于请求。

{"data":{"appName":"AppEmit","url":"http://www.appemit.com/","verDesc":"\u516C\u5171\u514D\u8D39\u7248(Public free Version)","verType":0,"version":"0.3.5"}," }

Obj

AppEmit

必需。

1. 1. 版本信息

{"emit":"version","Obj":"AppEmit"}

名称	设置	含义	说明
emit	version	必需。获得版本请求。	{"data":{"verDesc":"\u516C\u5171\u514D\u8D39\u7248(Public free Version)","verType":0,"version":"0.3.5"},"
Obj	AppEmit	必需。

问题

支持linux mac？

目前版本不支持，使用在windows系统上。

免费版本有何限制条件？

每80次消息发送时有弹窗。

收费版本没有限制，包括支持局域网。

测试点击连接，为何没有反应？

首先要打开AppEmit.exe服务，可以F12查看报错情况。重启系统后，AppEmit.exe进程自动开启，没有被关闭。

如何开发插件？

使用HPSocket的C接口。目前在测试中。

AppEmit是应用程序（尤其是浏览器）与本地程序间互相通信的易扩展的轻量级中间件

你可能感兴趣的:(AppEmit,javascript,websocket,chrome,dll,flash)