桌面应用开发引擎 AlloyDesktop

开发配置

其中的透明浏览器可用来在开发阶段进行调试。点击按钮切换网页渲染模式，默认使用不透明模式渲染。点击按钮或按F12或F9可打开开发者工具，强制刷新。点击浏览器右上角按钮可生成默认.app文件，app文件可双击直接运行app文件为一配置文件，可使用记事本打开，注意不要设为默认打开。可使用的配置项如下：

• url：网页地址

• name：程序名字

• icon：程序图标

• width：初始化窗口宽度

• height：初始化窗口高度

• x：初始化窗口x坐标（相对于屏幕）

• y：初始化窗口y坐标（相对于屏幕）

• enableDrag：是否允许全窗口拖拽，仅对透明窗口有效，1为真，0为假，以下同

• enableResize：是否允许改变窗口大小

• disableTransparent：是否禁用透明渲染

• disableRefresh：禁止按F5刷新

• disableDevelop：禁止按F12打开开发者工具

• hasBorder：是否使用默认边框

• max：初始化时是否最大化窗口，如果为真，则忽略width，height，x，y四个参数

• exStyle：高级参数，设置窗口额外属性，诸如置顶，去掉任务栏图标等

API文档

注：以下函数的最后一个参数都为handler，代表窗口句柄，不传则使用本窗口的句柄，只有在操作其他窗口时才有作用。请不要在全局变量中使用 handler这个变量名。以下API都是属于AlloyDesktop对象的，调用时请用AlloyDesktop.xx调用。

窗口相关

• bringToTop(handler);//窗口移到最顶层

• browse(url,handler);//在新进程中使用默认的透明浏览器浏览网页，url为网页路径

• close(handler);//关闭窗口

• createBrowser(url,handler);//在新进程中打开一个webtop窗口，url为网页路径

• createWindow(url,exStyle,isTransparent,readyHandler,handler)//在当前进程中创建一个窗口，并返回窗口句柄，readyHandler为窗口网页加载后要执行的js代码，此函数或将废弃

• createWindowBase(url,exstyle,isTransparent,readyHandler,handler);//同上，区别在于使用本地相对路径，此函数或将废弃

• drag(handler);//拖拽窗口

• enableDrag(handler);//允许拖拽窗口，同配置参数enableDrag=1作用相同。

• focus(handler);//使窗口获得焦点

• getPos(handler);//获得窗口位置，返回值为一object，格式如下{x:13,y:54}

• getScreenSize(handler);//获取屏幕大小，返回值为一object，格式如下{width:130,height:54}

• getSize(handler);//获得窗口大小，返回值为一object，格式如下{width:130,height:54}

• hide(handler);//隐藏窗口

• loadUrl(url,handler);//加载网页，url为网页路径

• max(handler);//最大化窗口

• mini(hander);//最小化窗口

• move(x,y,handler);//移动窗口

• ready(handler);//只对被创建出来的窗口有用，执行父窗口闯过来的js代码readyHandler

• reload(handler);//重新加载当前页面

• reloadIgnoreCache(handler);//重新加载当前页面并忽略缓存

• restore(handler);//还原窗口，对应于hide函数

• runApp(appName,param,handler);//运行一个app，appName为.app文件路径，param为参数，会带 在url上，格式如param=xxx，在app中可通过获取当前网页url从中提取出该参数。此函数不太稳定，请尽量使用runAppEx。

• runAppEx(appName,param,handler);//也是运行一个app，同runApp的区别是会新起一个进程运行app

• setSize(w,h,handler);//w为窗口宽度，h为窗口高度

• setTitle(title,handler);//设置窗口标题

• setTopMost(handler);//窗口置顶，此函数跟bringToTop的区别在于此函数会使窗口永远置顶，除非有另外一个窗口调用了置顶函数

• setWindowStyle(exStyle,handler);//高级函数，设置窗口额外属性，诸如置顶之类。

• showDev(handler);//打开开发者工具

• stopDrag(handler);//停止窗口拖拽

图像相关

• saveImageFromBase64(s,path,handler);//s为base64字符串，可通过canvas的toDataURL函数生成，path为保存路径，可以使用相对路径，即相对主网页文件的路径，以下同

• saveImageFromStream(id,width,height,path,handler);//id为二进制流id,下面会讲到如何创建二进制流，width为图像宽度，height为图像高度，path为图像保存路径

• toImage(path,handler);//把当前网页存为一张图片，支持透明，path为图像保存路径

• toImageEx(path,x,y,width,height,handler);//把当前网页的某一矩形区域存为图像，x和y为左上角坐标，width和height为宽度跟高度，ptah为图像保存路径

系统相关

• setTaskIcon(id,path,title,handler);//设置一托盘图标，id自己指定，确保不重复即可，path为图标文件所在路径，暂时只支持本地图标，title为鼠标移到图标上所要显示的文字

• delTaskIcon(id,handler);//删除一托盘图标，id为创建图标时使用的id

• findFiles(path,flag,handler);//查找文件，path为文件路径，支持通配符，flag为true则查找子目录， 返回格式为一数组，格式如下”["1.txt","AmfStream.cpp","AmfStream.h", {"name":"base","list":["2.txt"]}]，其中name为目录名，list为目录下的文件

• getCurrentDirectory(handler);//获取当前app文件所在目录

• getFolder(handler);//打开“选择文件夹”对话框，返回值为文件夹路径

• getFileSize(filename,handler);//获得文件大小，filename为文件路径，返回值为文件所占字节数

• getOpenName(filename,handler);//打开“打开文件”对话框，filename为对话框中要显示的默认名字，返回值为文件路径

• getOpenNames(filename,handler);//打开“打开文件”对话框，支持多选，filename为对话框中要显示的默认名字，返回值为一个数组，数组头一个元素为文件夹路径，剩余的元素为选择的各个文件名字。

• getSaveName(filename,handler);//打开“保存文件”对话框，filename为对话框中要显示的默认名字

• download(url,filename);//下载一文件，url为网址，filename为要保存的文件路径

• readFile(path,handler);//读取一文本文件的所有内容，返回值为文件内容的字符串

• writeFile(path,s,handler);//写一文本文件，s为要写入的字符串

• logOff(flag,handler);//注销windows系统，flag为true表示强制执行，以下同

• reboot(flag,handler);//重启系统

• quit(handler);//退出当前进程

• shutdown(flag,handler);//关闭系统

• createMemory(name,filename,size,handler);//创建一共享内存块，供二进制流读写使用，name为内 存块命名，不同进程可通过此名字进行共享内存操作，filename文件路径，如果不为空，则建立一磁盘文件，所有二进制操作将会写入此文件中，为空的话 则不创建文件，所有的二进制流只在内存中进行，size为文件大小，返回值为代表内存块的id

• createStream(id,handler);//创建一二进制文件流，id为调用createMemory函数创建内存块的返回值，返回值为代表二进制流的id

• deleteMemory(id,handler);//释放一内存块，id为createMemory函数的返回值。使用createMemory之后要记得调用此函数释放内存，否则会造成内存泄漏。

• deleteStream(id,handler);//释放一二进制流，id为createStream函数的返回值。使用createStream之后要记得调用此函数释放内存，否则会造成内存泄漏。

• getSharePos(handler);//获取默认共享内存块的二进制流读写指针位置。注：此内存块为所有进程共享，默认创建的

• setSharePos(i);设置共享内存块的二进制流读写指针位置

• getStreamPos(id,handler);//获取一二进制流的读写指针位置，id为二进制流id，单位为字节，id为二进制流id，不传则使用上面提到的默认的共享内存的二进制流，以下同

• setStreamPos(pos,id,handler);//设置一二进制流读写指针的位置，单位为字节

• readByte(id,handler);//读取一字节

• readBytes(l,id,handler);//读取连续内存块，l为内存块的长度，返回一二进制数组

• readInt(id,handler);//写入一占四位字节的整数

• readGB(l,id,handler);//读取固定长度的GB2312编码的字符串，l为字符串长度，注意一个汉字的长度为2

• readString(l,id,handler);//读取固定长度使用utf-8编码的字符串，l为字符串长度，以下同，注意一个汉字的长度为3

• readStringEx(l,id,handler);//读取固定长度的字符串，对应于writeStringEx。

• readWString(l,id,handler);//读取固定长度的宽字符串，一个宽字符占两个字节，无论英文或是中文，但是传递长度的参数时无需乘以2，只需传字数即可

• readWStringEx(l,id,handler);//读取固定长度的宽字符串，对应于writeWStringEx

• writeByte(b,id,handler);//向一二进制流写入一字节，b为要写入的数字

• writeBytes(arr,id,handler);//向二进制流写入固定长度的连续字节，arr为存储要写进去的数据的数组

• writeInt(i,id,handler);//读写一占四字节的整数

• writeString(s,id,handler);//写入一字符串

• writeStringEx(s,id,handler);//写入一字符串，与writeString不同的是此函数会在字符串前面写入三个字节，标明字符串的长度。

• writeWString(s,id,handler);//写入一宽字符串

• writeWStringEx(s,id,handler);//写入一宽字符串，与writeWString不同的是此函数会在字符串前面写入三个字节，标明字符串的长度。

P2P相关

• connect(ip,uid,handler);//连接到服务器，ip为服务器地址，uid为用户名，服务器在内网则使用内网地址，在外网就使用外网地址

• getIPAndPort;//获取当前webtop窗口所使用的ip和端口号，返回值为一object，结构如下：{ip:’192.169.0.102′,port:65345}

• getUsers(handler);//获取所有用户列表，该函数不会同步返回用户列表，调用后请监听webtopP2PUpdateUserList事件来得到用户列表，下面关于自定义事件部分会详细谈到。

• connectByHost(hostName,uid,handler);//连接到服务器，hostName为服务器名称，可以为局域网机器名字或者域名，uid为用户名

• sendMessage(userName,msg,handler);//向一用户发送消息，userName为用户名称，msg为要发送的消息

• sendMsgToIP(ip,port,msg,handler);//向某一ip地址发送消息，参数ip为ip地址，port为端口号，msg为要发送的消息

• sendMsgToServer(msg,handler);//向server发送消息

自定义事件

webtop中定义了一些自定义事件，如下 注，所有事件的回调函数都只有一个参数e，代表事件对象，其中e.detail对象为一object，包含事件的相关信息

• AlloyDesktopReady事件，webtop对象创建完成之后触发，有关webtop的初始化调用请放在此事件触发之后。 监听代码：addEventListener(“webtopReady”,readyHandler);//其中webtopReady为事件 名，readyHandler为事件的回调函数。以下事件的监听方法与此相同。注：对AlloyDesktopReady事件的监听请放在onload之 前。

• AlloyDesktopWindowResize：webtop窗口改变大小之后触发，e.detail的结构如下{width:243,heigh:234}。width和height为窗口的宽度和高度

• AlloyDesktopWindowMove：webtop窗口移动后触发，e.detail结构如下{x:34,y:43}，x和y为窗口的坐标，相对于屏幕

• AlloyDesktopDragDrop：当拖拽文件到窗口时触发，仅在透明渲染模式下有效（因为在此模式下html5的拖拽功能会失效）。 e.detail的结构如下{list:["E:/webtop/1.png","E:/webtop/2.png"]}。list为文件列表，存储各个 文件的路径

• AlloyDesktopDownload：下载进度事件，e.detail的结构如下 {filename:”xx”,count:423,contentLength:234234}，filename为文件路径，count为已下载字节 数，contentLength为要下载内容的字节数。

• AlloyDesktopDownloadComplete，下载完成事件。

• AlloyDesktopWindowActive：窗口激活时触发

• AlloyDesktopWindowFocus：窗口获得焦点时触发

• AlloyDesktopRefresh：//在用户按下F5时触发，仅在配置项disableRefresh=0时才会触发

• AlloyDesktopShowDev：//在用户按下F12时触发，仅在配置项disableDevelop=0时才会触发

• AlloyDesktopTaskMouse：在托盘图标上进行相关的鼠标操作后触发，e.detail的结构如下{type:34}，其中type代表鼠标动作的类型，为一整数，在实际开发中可通过打log来获取相关数值代表的鼠标类型

• AlloyDesktopWindowClose：webtop窗口被关闭时触发

• webtopMouseLeave：鼠标离开webtop窗口时触发

• webtopShowTip：在鼠标移到具有title属性的dom元素上面时触发（webtop没有实现默认的tips）

• webtopP2PRecieveMessage：在webtop窗口收到p2p消息时触发，e.detail的结构如下： {ip:’192.168.0.102′,port:64656,msg:’sfsdfsfasdf’}。ip为发送方的ip，port为发送方的端 口，msg为对方发送的消息

• AlloyDesktopP2PInitInfo：调用connect之后，p2p初始化之后触发，e.detail的结构如下： {ip:’192.168.0.102′,port:64656}。ip为当前webtop窗口使用的ip，port当前webtop窗口使用的端口

• AlloyDesktopP2PUpdateUserList：调用getUsers函数之后的回调事件。e.detail的结构如下 {list: ['192.168.0.102:55654_melody','192.168.0.101:55354_yukin'],ip:’192.168.0.102′ ,port:64656}。其中192.168.0.102为该用户的ip，55654为该用户的端口，melody为该用户的用户名。ip为当前 webtop窗口使用的ip，port当前webtop窗口使用的端口